Metodo IVideoWindow::p ut_BackgroundPalette (control.h)

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il put_BackgroundPalette metodo specifica se la finestra video si rende conto della relativa tavolozza in background.

Sintassi

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Parametri

[in] BackgroundPalette

Specifica se il renderer video lo rende disponibile in background. Deve essere uno dei valori seguenti:

Valore	Descrizione
OATRUE	Il renderer video realizza la tavolozza in background.
OAFALSE	Il renderer video non si rende conto della tavolozza in background. (impostazione predefinita).

Valore restituito

I valori restituiti possibili includono quanto segue:

Codice restituito	Descrizione
E_INVALIDARG	Argomento non valido.
S_OK	Operazione completata.
VFW_E_NOT_CONNECTED	Il filtro del renderer video non è connesso.

Commenti

Se BackgroundPalette è OATRUE e l'immagine video richiede una tavolozza, il renderer video si renderà conto che la tavolozza in background. Tutti i colori usati dalla tavolozza verranno modificati nella corrispondenza più vicina nella tavolozza di visualizzazione prima del disegno. Ciò garantisce che un'applicazione non avrà il suo tavolozza disturbato. Tuttavia, impone gravi sanzioni sulle prestazioni sul video.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	control.h (includere Dshow.h)
Libreria	Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IVideoWindow

IVideoWindow::get_BackgroundPalette