Share via


COLORKEY

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure communicates color key information between the renderer and another filter.

Syntax

typedef struct tagCOLORKEY{
  DWORD KeyType;
  DWORD PaletteIndex;
  COLORREF LowColorValue;
  COLORREF HighColorValue;
} COLORKEY;

Members

  • KeyType
    Key type. Can be CK_NOCOLORKEY, CK_INDEX, or CK_RGB. CK_INDEX and CK_RGB can be logically combined.
  • PaletteIndex
    Palette index.
  • LowColorValue
    Lowest RGB color value.
  • HighColorValue
    Highest RGB color value.

Remarks

The video renderer supports a data transport accessed through the IOverlay interface.

This will typically be used by hardware decoder filters that need the renderer to communicate where to put the data rather than requiring the renderer to draw the data.

One mechanism for communicating where to put the images is by using a color key. This structure is used by a filter (typically a hardware decoder) to describe color key requirements to the video renderer.

Requirements

Header dshow.h
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later

See Also

Reference

DirectShow Structures