ICM_DECOMPRESS_SET_PALETTE
The
ICM_DECOMPRESS_SET_PALETTE message specifies a palette for a video
decompression driver to use if it is decompressing to a format that uses a
palette. You can send this message explicitly or by using the ICDecompressSetPalette macro.
ICM_DECOMPRESS_SET_PALETTE
wParam = (DWORD) (LPVOID) lpbiPalette;
lParam = 0;
Parameters
lpbiPalette
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.
Return Values
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.
Remarks
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.
See Also