IVideoWindow::p ut_BackgroundPalette-Methode (control.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 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 |
|---|---|
|
Ungültiges Argument. |
|
Erfolg. |
|
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 |