DVM_PALETTE

Notifies a video capture driver to set and retrieve a logical palette used by a video device channel. This message applies only to VIDEO_IN and VIDEO_OUT channels.

• Returns DV_ERR_OK if successful or an error code otherwise. The DV_ERR_NOTSUPPORTED error indicates the message is not supported.

dwFlags

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

VIDEO_CONFIGURE_SET	Sends a palette to the driver.
VIDEO_CONFIGURE_GET	Obtains the current palette from the driver.
VIDEO_CONFIGURE_QUERY	Interrogates the driver to determine if it supports the message.
VIDEO_CONFIGURE_QUERYSIZE	Returns the size in bytes of the palette in lpdwReturn. This flag is only valid if the VIDEO_CONFIGURE_GET flag is also set.

lpVConfigParms

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

lpdwReturn	Address of a DWORD. If the VIDEO_CONFIGURE_QUERYSIZE flag is used, the driver fills this field with the size (in bytes) of the logical palette.
lpData1	Address of a LOGPALETTE structure.
dwSize1	Size, in bytes, of the LOGPALETTE structure.
lpData2, dwSize2	Not used.

Either the VIDEO_CONFIGURE_SET or the VIDEO_CONFIGURE_GET flag must be set to specify the direction of the transfer.

A palette is used when converting between frame buffer internal data formats and 8-bit palettized DIBs.