IOverlay::SetColorKey-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 SetColorKey -Methode ändert den Farbschlüssel.

Syntax

HRESULT SetColorKey(
  [in, out] COLORKEY *pColorKey
);

Parameter

[in, out] pColorKey

Zeiger auf den festzulegenden Farbschlüsselwert. Bei erfolgreicher Ausführung wird der tatsächliche ausgewählte Farbschlüsselwert in diesen Parameter kopiert.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück, E_POINTER, wenn pColorKeyNULL ist, oder E_INVALIDARG, wenn der Wert von pColorKey für das aktuelle Paletten- oder Pixelformat ungültig ist.

Hinweise

Wenn Sie den Farbschlüssel mithilfe der SetColorKey -Methode ändern, erhalten alle Empfehlungslinks eine IOverlayNotify::OnColorKeyChange-Rückrufmethode mit der neuen Farbe.

Wenn Sie IOverlay::Advise auf einer palettisierten Anzeige verwenden, kann ein Filter entweder eine Farbtaste (mit SetColorKey) oder eine Palette (mit IOverlay::SetPalette) installieren, aber nicht beides. Dies liegt daran, dass Farbtasten in diesem Modus eine Palette erfordern, die mit SetPalette in Konflikt steht. Farbtasten können deinstalliert werden, indem sie einen Farbschlüssel mit dem CK_NOCOLORKEY-Flag anfordern. Ebenso kann jede über SetPalette installierte Palette deinstalliert werden, indem SetPalette aufgerufen und NULL-Parameter übergeben werden (d. b. SetPalette(0,NULL)).

Beim Versuch, eine Palette festzulegen, wenn ein Farbschlüssel installiert wird, wird ein VFW_E_PALETTE_SET Fehler zurückgegeben. Wenn Sie versuchen, einen Farbschlüssel festzulegen, wenn eine Palette installiert wird, wird VFW_E_COLOR_KEY_SET zurückgegeben.

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