Método CImagePalette.PreparePalette

Artículo
07/28/2023

[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 PreparePalette método configura una paleta, basada en un tipo de medio del filtro propietario.

Sintaxis

HRESULT PreparePalette(
   const CMediaType *pmtNew,
   const CMediaType *pmtOld,
         LPSTR      szDevice
);

Parámetros

pmtNew: Puntero al nuevo tipo de medio. El bloque de formato debe ser una estructura VIDEOINFOHEADER .
pmtOld: Puntero al tipo de medio antiguo. Si el tipo de medio se establece por primera vez, este parámetro puede ser un tipo vacío sin ningún bloque de formato. De lo contrario, el bloque de formato debe ser una estructura VIDEOINFOHEADER .
szDevice: Puntero a una cadena que contiene el nombre del dispositivo para mostrar, tal y como devuelve la función GDI EnumDisplayDevices . Para usar el dispositivo de visualización principal, establezca este parámetro en NULL.

Valor devuelto

Devuelve S_OK si se actualizó la paleta o S_FALSE si la paleta no cambió.

Observaciones

Si es necesario actualizar la paleta, este método realiza las siguientes acciones:

Llama a CImagePalette::MakePalette para crear una nueva paleta lógica.
Envía un evento EC_PALETTE_CHANGED al Administrador de gráficos de filtros.
Llama a CBaseWindow::SetPalette en el objeto CBaseWindow .
Llama a CDrawImage::IncrementPaletteVersion en el objeto CDrawImage .

Requisitos

Requisito	Value
Encabezado	Winutil.h (include Streams.h)
Biblioteca	Strmbase.lib (compilaciones comerciales); Strmbasd.lib (compilaciones de depuración)

Consulte también

CImagePalette (clase)

Share via