Freigeben über


CBaseControlWindow.put_BackgroundPalette-Methode

[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 put_BackgroundPalette -Methode legt ein Flag fest, um die Palette im Hintergrund zu realisieren.

Syntax

HRESULT put_BackgroundPalette(
   long BackgroundPalette
);

Parameter

BackgroundPalette

Automation Boolesches Flag (0 ist deaktiviert, 1 ist aktiviert).

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Bemerkungen

Um ein Video in einer anderen Anwendung oder einem anderen Dokument wiederzugeben, möchte die Anwendung möglicherweise eine eigene Palette verwenden. Es kann das Video bitten, dass die aktuelle Vordergrundpalette anstelle ihrer eigenen als Hintergrundpalette verwendet wird, indem dieses Flag auf 1 festgelegt wird. Wenn dies auf 0 festgelegt ist, installiert das Fenster seine eigene bevorzugte Palette und realisiert sie. Wenn Sie das Fenster bitten, eine andere Palette zu verwenden, wird dies zu schwerwiegenden Leistungseinbußen führen.

Anforderungen

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

Siehe auch

CBaseControlWindow-Klasse