DVM_PALETTERGB555

Notifies a video capture driver to associate an RGB555 palette with a video device channel. Applications can provide an RGB555 translation table to a driver for fast conversions between RGB formats and 8-bit palettized formats.

Returns DV_ERR_OK if successful or an error code otherwise. The following error codes are defined:

DV_ERR_NOTSUPPORTED	Indicates the message is not supported.
DV_ERR_CREATEPALETTE	Indicates the driver is not able to associate the palette with the video device channel.
DV_ERR_PARM1	Indicates the information supplied for dwParam1 is invalid.
DV_ERR_PARM2	Indicates the information supplied for dwParam2 is invalid.
DV_ERR_SIZEFIELD	Indicates the data structure supplied for the format is too small.

dwFlags

Flags indicating the type of palette transfer requested. The following flags are defined:

VIDEO_CONFIGURE_SET	Indicates values are being sent to the driver.
VIDEO_CONFIGURE_QUERY	This flag, when combined with VIDEO_CONFIGURE_SET is used to query the driver to determine if it supports the message.

lpVConfigParms

Address of a VIDEOCONFIGPARMS structure. The VIDEOCONFIGPARMS structure has the following members:

lpdwReturn	Not used.
lpData1	Address of a LOGPALETTE structure.
dwSize1	Size, in bytes, of the LOGPALETTE structure.
lpData2	Address of a 32 kilobyte RGB555 translation table . This table is used by the device driver to translate from RGB555 triplets into palette colors when capturing in 8 bit palette mode.
dwSize2	Size, in bytes, of the translate table. This value must be 32,768.

This message applies only to VIDEO_IN and VIDEO_OUT channels.

A translation table provides a fast method of converting between RGB and palettized color spaces. The palette index corresponding to an RGB color is found by indexing the translation table at xRRRRRGGGGGBBBBB (the five most significant bits of each color component is used to create the index).