ICDecompressExBegin

The ICDecompressExBegin function prepares a decompressor for decompressing data.

DWORD ICDecompressExBegin(
  HIC hic,                     
  DWORD dwFlags,               
  LPBITMAPINFOHEADER lpbiSrc,  
  LPVOID lpSrc,                
  int xSrc,                    
  int ySrc,                    
  int dxSrc,                   
  int dySrc,                   
  LPBITMAPINFOHEADER lpbiDst,  
  LPVOID lpDst,                
  int xDst,                    
  int yDst,                    
  int dxDst,                   
  int dyDst                    
);
 

Parameters

hic

Handle of the decompressor to use.

dwFlags

Decompression flags. The following values are defined:

ICDECOMPRESS_HURRYUP

Tries to decompress at a faster rate. When an application uses this flag, the driver should buffer the decompressed data but not draw the image.

ICDECOMPRESS_NOTKEYFRAME

Current frame is not a key frame.

ICDECOMPRESS_NULLFRAME

Current frame does not contain data and the decompressed image should be left the same.

ICDECOMPRESS_PREROLL

Current frame precedes the point in the movie where playback starts and, therefore, will not be drawn.

ICDECOMPRESS_UPDATE

Screen is being updated or refreshed.

lpbiSrc

Address of a BITMAPINFOHEADER structure containing the format of the compressed data.

lpSrc

Address of the input data.

xSrc, ySrc

The x- and y-coordinates of the source rectangle for the DIB specified by lpbiSrc.

dxSrc, dySrc

Width and height of the source rectangle.

lpbiDst

Address of a BITMAPINFOHEADER structure containing the output format.

lpDst

Address of a buffer that is large enough to contain the decompressed data.

xDst, yDst

The x- and y-coordinates of the destination rectangle for the DIB specified by lpbiDst.

dxDst, dyDst

Width and height of the destination rectangle.

Return Values

Returns ICERR_OK if successful or an error otherwise.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Import Library: Use vfw32.lib.

See Also

Video Compression Manager Overview, Video Compression Functions, BITMAPINFOHEADER