ICGetDisplayFormat function (vfw.h)

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.

Syntax

HIC VFWAPI 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 value

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

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header vfw.h
Library Vfw32.lib
DLL Msvfw32.dll

See also

Video Compression Functions

Video Compression Manager