ICGetDisplayFormat

	Overview

	Group

	Quick Info

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.