ICImageDecompress function (vfw.h)

Article
02/22/2024

The ICImageDecompress function decompresses an image without using initialization functions.

Syntax

HANDLE VFWAPI ICImageDecompress(
  HIC          hic,
  UINT         uiFlags,
  LPBITMAPINFO lpbiIn,
  LPVOID       lpBits,
  LPBITMAPINFO lpbiOut
);

Parameters

hic

Handle to a decompressor opened with the ICOpen function. Specify NULL to have VCM select an appropriate decompressor for the compressed image.

uiFlags

Reserved; must be zero.

lpbiIn

Compressed input data format.

lpBits

Pointer to input data bits to compress. The data bits exclude header and format information.

lpbiOut

Decompressed output format. Specify NULL to let decompressor use an appropriate format.

Return value

Returns a handle to an uncompressed DIB in the CF_DIB format if successful or NULL otherwise. Image data follows the format header.

Remarks

To obtain the format information from the LPBITMAPINFOHEADER structure, use the GlobalLock function to lock the data. Use the GlobalFree function to free the DIB when you are finished.

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