Método IVideoWindow::p ut_BackgroundPalette (control.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O put_BackgroundPalette método especifica se a janela de vídeo percebe sua paleta em segundo plano.

Sintaxe

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Parâmetros

[in] BackgroundPalette

Especifica se o renderizador de vídeo percebe sua paleta em segundo plano. Deve ser um dos seguintes valores:

Valor	Descrição
OATRUE	O renderizador de vídeo percebe a paleta em segundo plano.
OAFALSE	O renderizador de vídeo não percebe a paleta em segundo plano. (Padrão.)

Retornar valor

Os possíveis valores retornados incluem o seguinte:

Código de retorno	Descrição
E_INVALIDARG	Argumento inválido.
S_OK	Êxito.
VFW_E_NOT_CONNECTED	O filtro do renderizador de vídeo não está conectado.

Comentários

Se BackgroundPalette for OATRUE e a imagem de vídeo exigir uma paleta, o renderizador de vídeo perceberá essa paleta em segundo plano. Todas as cores usadas pela paleta serão alteradas para a correspondência mais próxima na paleta de exibição antes do desenho. Isso garante que um aplicativo não tenha sua paleta perturbada. No entanto, ele impõe severas penalidades de desempenho no vídeo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	control.h (inclua Dshow.h)
Biblioteca	Strmiids.lib

Confira também

Códigos de erro e êxito

IVideoWindow Interface

IVideoWindow::get_BackgroundPalette