ICDecompressEx

The ICDecompressEx function decompresses a single video frame.

DWORD ICDecompressEx(
  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.

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.

Remarks

Typically, applications use the ICDECOMPRESS_PREROLL flag to seek to a key frame in a compressed stream. The flag is sent with the key frame and with subsequent frames required to decompress the desired frame.

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