Compartir a través de


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