IOverlay::GetDefaultColorKey-Methode (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 GetDefaultColorKey -Methode ruft den Standardfarbschlüssel ab, der für eine Chroma-Tastenüberlagerung verwendet wird.

Syntax

HRESULT GetDefaultColorKey(
  [out] COLORKEY *pColorKey
);

Parameter

[out] pColorKey

Zeiger auf eine Variable, die den Standardfarbschlüssel empfängt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Ein Filter mit Farbtasten kann eine Standardfarbe vom Videorenderer abrufen. Der Standardfarbschlüssel kann dann mithilfe von IOverlay::SetColorKey im Fenster installiert werden. Die farben, die durch diese Methode zurückgegeben werden, variieren je nach aktuellem Anzeigemodus. Wenn die Farben 8-Bit palettisiert sind, handelt es sich um helle Systemfarben (z. B. Magenta). Wenn sich die Anzeige in einem True-Color-Modus befindet, sind sie schwarz.

Die IOverlay-Schnittstelle wird verwendet, um sicherzustellen, dass separate Instanzen des Renderers auf demselben Computer unterschiedliche Farbtasten erhalten, damit Überlagerungen nicht in Konflikt stehen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IOverlay-Schnittstelle