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
| 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 | strmif.h (incluye Dshow.h) |
| Library | Strmiids.lib |