Partager via

ICDecompressEx

  • Article

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 to the decompressor.

dwFlags

Decompression flags. The following values are defined.

Value Meaning
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

Pointer to a BITMAPINFOHEADER structure containing the format of the compressed data.

lpSrc

Pointer to the input data.

xSrc

The x-coordinate of the source rectangle for the DIB specified by lpbiSrc.

ySrc

The y-coordinate of the source rectangle for the DIB specified by lpbiSrc.

dxSrc

Width of the source rectangle.

dySrc

Height of the source rectangle.

lpbiDst

Pointer to a BITMAPINFOHEADER structure containing the output format.

lpDst

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

xDst

The x-coordinate of the destination rectangle for the DIB specified by lpbiDst.

yDst

The y-coordinate of the destination rectangle for the DIB specified by lpbiDst.

dxDst

Width of the destination rectangle.

dyDst

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.

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.
**  Library:** Use Vfw32.lib.

See Also

Video Compression Manager, Video Compression Functions, BITMAPINFOHEADER