IMixerPinConfig::GetColorKey-Methode (mpconfig.h)

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetColorKey -Methode ruft den Farbschlüssel ab, der von einem Videostream verwendet wird.

Syntax

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey,
  [out] DWORD    *pColor
);

Parameter

[out] pColorKey

Zeiger auf eine COLORKEY-Struktur , die den Schlüsseltyp und einen Palettenindex enthält.

[out] pColor

Zeiger auf einen Wert, der den 8-Bit-Palettenindex des zurückgegebenen COLORKEY angibt, wenn der aktuelle Anzeigemodus 8-Bit palettisiert ist. Andernfalls handelt es sich um einen Wert, der die Farbtaste im Pixelformat des aktuellen Anzeigemodus darstellt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode	Beschreibung
E_INVALIDARG	Ungültige Argumente, beide Parameter sind NULL.
E_FAIL	`GetColorKey` Fehler, weil die Farbtaste nicht bekannt ist.
NOERROR	Erfolg.

Bemerkungen

Durch das Abrufen des Werts für den primären Stream wird der Zielfarbschlüssel abgerufen, der von der Überlagerungsoberfläche verwendet wird. Wenn Sie diesen Wert auf dem sekundären Pin abrufen, wird der Farbschlüssel zurückgegeben, der von diesem bestimmten Stream verwendet wird.

Die aktuelle DirectShow-Implementierung dieser Schnittstelle kann NULL für den pColorKey - oder pColor-Parameter zurückgeben. Die Methode schlägt jedoch fehl und gibt E_INVALIDARG zurück, wenn beide Parameter NULL sind.

Hinweis Der vom pColor-Parameter zurückgegebene DWORD-Wert ist die tatsächliche Farbe, die verwendet wird. Wenn also die Bittiefe der Anzeige 8, 16, 24, 32 beträgt, geben die letzten 8, 16, 24 oder 32 Bits des DWORD den tatsächlichen Wert der Farbtaste an.

Anforderungen


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

Siehe auch

Fehler- und Erfolgscodes

IMixerPinConfig-Schnittstelle

IMixerPinConfig::SetColorKey

Freigeben über