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

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El put_BackgroundPalette método especifica si la ventana de vídeo se da cuenta de su paleta en segundo plano.

Sintaxis

HRESULT put_BackgroundPalette(
  [in] long BackgroundPalette
);

Parámetros

[in] BackgroundPalette

Especifica si el representador de vídeo se da cuenta de la paleta en segundo plano. Debe ser uno de los siguientes valores:

Valor	Descripción
OATRUE	El representador de vídeo se da cuenta de la paleta en segundo plano.
OAFALSE	El representador de vídeo no se da cuenta de la paleta en segundo plano. (Valor predeterminado).

Valor devuelto

Entre los valores devueltos posibles se incluyen los siguientes:

Código devuelto	Descripción
E_INVALIDARG	Argumento no válido.
S_OK	Correcto.
VFW_E_NOT_CONNECTED	El filtro del representador de vídeo no está conectado.

Comentarios

Si BackgroundPalette es OATRUE y la imagen de vídeo requiere una paleta, el representador de vídeo se dará cuenta de esa paleta en segundo plano. Los colores que use la paleta cambiarán a su coincidencia más cercana en la paleta de presentación antes del dibujo. Esto garantiza que una aplicación no tenga su paleta molestada. Sin embargo, impone graves penalizaciones de rendimiento en el vídeo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	control.h (include Dshow.h)
Library	Strmiids.lib

Consulte también

Códigos de error y éxito

IVideoWindow (interfaz)

IVideoWindow::get_BackgroundPalette