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 of the compressor to use. Specify NULL to have VCM select and open an appropriate compressor.

lpbiIn

Address of BITMAPINFOHEADER structure containing the compressed format.

lpbiOut

Address of 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, dy

Width and height multipliers 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.

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