ICDRAWBEGIN structure (vfw.h)

  • Article

The ICDRAWBEGIN structure contains decompression parameters used with the ICM_DRAW_BEGIN message.

Syntax

typedef struct {
  DWORD              dwFlags;
  HPALETTE           hpal;
  HWND               hwnd;
  HDC                hdc;
  int                xDst;
  int                yDst;
  int                dxDst;
  int                dyDst;
  LPBITMAPINFOHEADER lpbi;
  int                xSrc;
  int                ySrc;
  int                dxSrc;
  int                dySrc;
  DWORD              dwRate;
  DWORD              dwScale;
} ICDRAWBEGIN;

Members

dwFlags

Applicable flags. The following values are defined:

Name Description
ICDRAW_ANIMATE
 Application can animate the palette.
ICDRAW_BUFFER
 Buffers this data off-screen; it will need to be updated.
ICDRAW_CONTINUE
 Drawing is a continuation of the previous frame.
ICDRAW_FULLSCREEN
 Draws the decompressed data on the full screen.
ICDRAW_HDC
 Draws the decompressed data to a window or a DC.
ICDRAW_MEMORYDC
 DC is off-screen.
ICDRAW_QUERY
 Determines if the decompressor can handle the decompression. The driver does not actually decompress the data.
ICDRAW_RENDER
 Renders but does not draw the data.
ICDRAW_UPDATING
 Current frame is being updated rather than played.

hpal

Handle to the palette used for drawing.

hwnd

Handle to the window used for drawing.

hdc

Handle to the DC used for drawing. Specify NULL to use a DC associated with the specified window.

xDst

The x-coordinate of the destination rectangle.

yDst

The y-coordinate of the destination rectangle.

dxDst

Width of the destination rectangle.

dyDst

Height of the destination rectangle.

lpbi

Pointer to a BITMAPINFOHEADER structure containing the input format.

xSrc

The x-coordinate of the source rectangle.

ySrc

The y-coordinate of the source rectangle.

dxSrc

Width of the source rectangle.

dySrc

Height of the source rectangle.

dwRate

Decompression rate in an integer format. To obtain the rate in frames per second, divide this value by the value in dwScale.

dwScale

Value used to scale dwRate to frames per second.

Requirements

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

See also

ICM_DRAW_BEGIN

Video Compression Manager

Video Compression Structures