ICDRAWBEGIN

  • Article

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

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:

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

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Compression Manager, Video Compression Structures, BITMAPINFOHEADER, ICM_DRAW_BEGIN