ICM_DECOMPRESS_SET_PALETTE

See also ICM_DECOMPRESS_BEGIN, ICM_DECOMPRESS_GET_FORMAT

wParam = (DWORD) (LPVOID) lpbiPalette;
lParam = 0;

Specifies a palette for a video decompression driver to use if it is decompressing to a format that uses a palette.

• Returns ICERR_OK if the decompression driver can precisely decompress images to the suggested palette using the set of colors as they are arranged in the palette. Returns ICERR_UNSUPPORTED otherwise.

wParam

Address of a BITMAPINFOHEADER structure whose color table contains the colors that should be used if possible. You can specify zero to use the default set of output colors.

This message should not affect decompression already in progress; rather, colors passed using this message should be returned in response to future ICM_DECOMPRESS_GET_FORMAT and ICM_DECOMPRESS_GET_PALETTE messages. Colors are sent back to the decompression driver in a future ICM_DECOMPRESS_BEGIN message.

This message is used primarily when a driver decompresses images to the screen and another application that uses a palette is in the foreground, forcing the decompression driver to adapt to a foreign set of colors.