Share via

Método CImagePalette.MakeIdentityPalette

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O MakeIdentityPalette método tenta criar uma "paleta de identidades", definida como uma que mapeia diretamente para a paleta selecionada no dispositivo de exibição.

Sintaxe

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

Parâmetros

pEntry

Ponteiro para uma matriz de entradas de paleta.

iColorrs

Número de entradas de paleta no pEntry.

szDevice

Ponteiro para uma cadeia de caracteres que contém o nome do dispositivo de exibição, conforme retornado pela função GDI EnumDisplayDevices . Para usar o dispositivo de exibição main, defina esse parâmetro como NULL.

Retornar valor

Retorna S_OK se tiver êxito ou S_FALSE se não tiver êxito.

Comentários

Esse método compara as entradas reservadas na paleta do sistema com as entradas correspondentes na matriz pEntry . Se corresponderem exatamente, o método definirá o sinalizador PC_NOCOLLAPSE nas entradas de paleta restantes (não reservadas) no pEntry. Esse sinalizador impede que a GDI tente mapear entradas de paleta lógica para entradas de paleta do sistema.

O método CImagePalette::MakePalette chama esse método.

Requisitos

Requisito Valor
parâmetro
Winutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CImagePalette