ICDecompressGetPalette

  • Article

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.

DWORD 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 Values

Returns ICERR_OK if successful or an error otherwise.

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

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Vfw.h.

See Also

Video Compression Manager, Video Compression Macros, BITMAPINFO, BITMAPINFOHEADER, ICM_DECOMPRESS_GET_PALETTE