Compartir a través de


Método CImagePalette.PreparePalette

[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:

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)