ICGetDisplayFormat

The ICGetDisplayFormat function determines the best format available for displaying a compressed image. The function also opens a compressor if a handle of an open compressor is not specified.

HIC ICGetDisplayFormat(
  HIC hic,                    
  LPBITMAPINFOHEADER lpbiIn,  
  LPBITMAPINFOHEADER lpbiOut,  
  int BitDepth,               
  int dx,                     
  int dy                      
);

Parameters

hic

Handle to the compressor to use. Specify NULL to have VCM select and open an appropriate compressor.

lpbiIn

Pointer to BITMAPINFOHEADER structure containing the compressed format.

lpbiOut

Pointer to a buffer to return the decompressed format. The buffer should be large enough for a BITMAPINFOHEADER structure and 256 color entries.

BitDepth

Preferred bit depth, if nonzero.

dx

Width multiplier to stretch the image. If this parameter is zero, that dimension is not stretched.

dy

Height multiplier to stretch the image. If this parameter is zero, that dimension is not stretched.

Return Values

Returns a handle to a decompressor if successful or zero otherwise.

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