ICDecompressGetPalette macro (vfw.h)

Article
02/22/2024

The ICDecompressGetPalette macro requests that the video decompression driver supply the color table of the output BITMAPINFOHEADER structure. You can use this macro or explicitly call the ICM_DECOMPRESS_GET_PALETTE message.

Syntax

void ICDecompressGetPalette(
   hic,
   lpbiInput,
   lpbiOutput
);

Parameters

hic

Handle to a decompressor.

lpbiInput

Pointer to a BITMAPINFOHEADER structure containing the input format.

lpbiOutput

Pointer to a BITMAPINFOHEADER structure to contain the color table. The space reserved for the color table is always at least 256 colors. You can specify zero for this parameter to return only the size of the color table.

Return value

None

Remarks

If lpbiOutput is nonzero, the driver sets the biClrUsed member of BITMAPINFOHEADER to the number of colors in the color table. The driver fills the bmiColors members of BITMAPINFO with the actual colors.

The driver should support this message only if it uses a palette other than the one specified in the input format.

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