Método CImagePalette.MakeIdentityPalette

[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 MakeIdentityPalette método intenta realizar una "paleta de identidades", definida como una que se asigna directamente a la paleta seleccionada en el dispositivo para mostrar.

Sintaxis

HRESULT MakeIdentityPalette(
   PALETTEENTRY *pEntry,
   INT          iColours,
   LPSTR        szDevice
);

Parámetros

pEntry

Puntero a una matriz de entradas de paleta.

iColours

Número de entradas de paleta en pEntry.

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 realiza correctamente o S_FALSE si no se realiza correctamente.

Observaciones

Este método compara las entradas reservadas de la paleta del sistema con las entradas correspondientes de la matriz pEntry . Si coinciden exactamente, el método establece la marca PC_NOCOLLAPSE en las entradas de paleta restantes (no reservadas) en pEntry. Esta marca impide que GDI intente asignar entradas de paleta lógica a entradas de paleta del sistema.

El método CImagePalette::MakePalette llama a este método.

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)