Freigeben über


COLORKEY-Struktur (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die COLORKEY -Struktur kommuniziert Farbschlüsselinformationen zwischen dem Renderer und einem anderen Filter.

Syntax

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

Member

KeyType

Schlüsseltyp. Kann CK_NOCOLORKEY, CK_INDEX oder CK_RGB sein. Die CK_INDEX und CK_RGB können mit einem bitweisen OR kombiniert werden.

PaletteIndex

Palettenindex.

LowColorValue

Niedrigster RGB-Farbwert.

HighColorValue

Höchster RGB-Farbwert.

Bemerkungen

Der Videorenderer unterstützt einen Datentransport, auf den über die IOverlay-Schnittstelle zugegriffen wird. Dies wird in der Regel von Hardwaredecoderfiltern verwendet, die den Renderer benötigen, um zu kommunizieren, wo die Daten platziert werden sollen, anstatt dass der Renderer die Daten zeichnen muss. Ein Mechanismus für die Kommunikation, wo die Bilder platziert werden sollen, ist die Verwendung eines Farbschlüssels. Diese Struktur wird von einem Filter (in der Regel ein Hardwaredecoder) verwendet, um die Farbschlüsselanforderungen für den Videorenderer zu beschreiben.

Requirements (Anforderungen)

   
Kopfzeile strmif.h (include Dshow.h)

Siehe auch

DirectShow-Strukturen