Método IOverlay::SetPalette (strmif.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 SetPalette método establece la paleta.

Sintaxis

HRESULT SetPalette(
  [in] DWORD        dwColors,
  [in] PALETTEENTRY *pPalette
);

Parámetros

[in] dwColors

Número de colores presentes.

[in] pPalette

Puntero a los colores que se van a usar para la paleta.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. Si se produce un error en el método, devuelve un código de error HRESULT .

Observaciones

Este método establece una paleta lógica para la ventana. No se garantiza que la ventana siempre tenga los colores solicitados en la paleta de dispositivos del sistema real. El sistema operativo Microsoft® Windows® solo garantiza esos colores cuando la ventana es la ventana activa en primer plano. La paleta de dispositivos actual se puede obtener llamando a IOverlay::GetPalette.

Si el dispositivo no tiene una paleta, devuelve VFW_E_NO_DISPLAY_PALETTE.

El filtro Mezclador de superposición devuelve E_NOTIMPL.

Requisitos

Consulte también

Códigos de error y éxito

IOverlay (interfaz)