Freigeben über


CBaseControlWindow.get_BackgroundPalette-Methode

[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 get_BackgroundPalette -Methode ruft die realisierte Palette im Hintergrundflag ab.

Syntax

HRESULT get_BackgroundPalette(
   long *pBackgroundPalette
);

Parameter

pBackgroundPalette

Zeiger auf ein boolesches Automation-Flag (0 ist deaktiviert, 1 ist aktiviert).

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Diese Memberfunktion implementiert die IVideoWindow::get_BackgroundPalette-Methode . Wenn ein Video in einer anderen Anwendung oder einem anderen Dokument wiedergegeben wird, möchte die Anwendung möglicherweise eine eigene Palette verwenden. Es kann das Video bitten, die aktuelle Vordergrundpalette anstelle ihrer eigenen zu verwenden, indem dieses Flag auf 1 festgelegt wird. Wenn dies auf 0 festgelegt ist, installiert das Fenster seine eigene bevorzugte Palette und realisiert sie. Beachten Sie, dass die Aufforderung zum Verwenden einer anderen Palette im Fenster zu schwerwiegenden Leistungseinbußen führt.

Anforderungen

Anforderung Wert
Header
Ctlutil.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseControlWindow-Klasse