IVideoWindow::p ut_BackgroundPalette-Methode (control.h)

  • Artikel

[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 gibt an, ob das Videofenster seine Palette im Hintergrund realisiert.

Syntax

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Parameter

[in] BackgroundPalette

Gibt an, ob der Videorenderer die Palette im Hintergrund erkennt. Dies muss einer der folgenden Werte sein:

Wert BESCHREIBUNG
OATRUE Der Videorenderer realisiert die Palette im Hintergrund.
OAFALSE Der Videorenderer erkennt die Palette im Hintergrund nicht. (Standardeinstellung)

Rückgabewert

Folgende Rückgabewerte sind möglich:

Rückgabecode Beschreibung
E_INVALIDARG
 Ungültiges Argument.
S_OK
 Erfolg.
VFW_E_NOT_CONNECTED
 Der Videorendererfilter ist nicht verbunden.

Hinweise

Wenn BackgroundPaletteAUF OATRUE festgelegt ist und das Videobild eine Palette erfordert, erkennt der Videorenderer diese Palette im Hintergrund. Alle Farben, die von der Palette verwendet werden, ändern sich vor dem Zeichnen in der Anzeigepalette in die nächste Übereinstimmung. Dadurch wird sichergestellt, dass die Palette einer Anwendung nicht gestört wird. Es verhängt jedoch schwere Leistungseinbußen für das Video.

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 control.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IVideoWindow-Schnittstelle

IVideoWindow::get_BackgroundPalette