ICDecompressGetPalette

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 of a decompressor.
lpbiInput
Address of a BITMAPINFOHEADER structure containing the input format.
lpbiOutput
Address of 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.

See Also

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