ICDRAW structure (vfw.h)

The ICDRAW structure contains parameters for drawing video data to the screen. This structure is used with the ICM_DRAW message.

Syntax

typedef struct {
  DWORD  dwFlags;
  LPVOID lpFormat;
  LPVOID lpData;
  DWORD  cbData;
  LONG   lTime;
} ICDRAW;

dwFlags

Flags from the AVI file index. The following values are defined:

Name	Description
ICDRAW_HURRYUP	Data is buffered and not drawn to the screen. Use this flag for fastest decompression.
ICDRAW_NOTKEYFRAME	Current frame is not a key frame.
ICDRAW_NULLFRAME	Current frame does not contain any data, and the previous frame should be redrawn.
ICDRAW_PREROLL	Current frame of video occurs before playback should start. For example, if playback will begin on frame 10, and frame 0 is the nearest previous key frame, frames 0 through 9 are sent to the driver with this flag set. The driver needs this data to display frame 10 properly.
ICDRAW_UPDATE	Updates the screen based on data previously received. In this case, lpData should be ignored.

lpFormat

Pointer to a structure containing the data format. For video streams, this is a BITMAPINFOHEADER structure.

lpData

Pointer to the data to render.

cbData

Number of data bytes to render.

lTime

Time, in samples, when this data should be drawn. For video data this is normally a frame number.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	vfw.h