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