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.
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).