ICDecompressSetPalette
The ICDecompressSetPalette
macro specifies a palette for a video decompression driver to use if it is
decompressing to a format that uses a palette. You can use this macro or
explicitly call the ICM_DECOMPRESS_SET_PALETTE message.
ICDecompressSetPalette(
|
hic, |
|
|
lpbiPalette |
|
|
); |
|
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 macro
should not affect decompression already in progress; rather, colors passed
using this message should be returned in response to future ICDecompressGetFormat
and ICDecompressGetPalette macros. Colors are sent back to the
decompression driver in a future ICDecompressBegin macro.
This macro 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