Função XLATEOBJ_cGetPalette (winddi.h)

A função XLATEOBJ_cGetPalette recupera cores RGB ou o formato bitfields da paleta especificada.

Sintaxe

ENGAPI ULONG XLATEOBJ_cGetPalette(
       XLATEOBJ *pxlo,
  [in] ULONG    iPal,
       ULONG    cPal,
       ULONG    *pPal
);

Parâmetros

pxlo

Ponteiro para a estrutura XLATEOBJ da qual o GDI recupera as informações solicitadas.

[in] iPal

Identifica as informações de paleta a serem gravadas. Esse parâmetro pode usar um dos valores a seguir:

Valor	Significado
XO_DESTBITFIELDS	O GDI recupera o formato bitfields da paleta de destino.
XO_DESTPALETTE	O GDI recupera cores RGB da paleta de destino.
XO_SRCBITFIELDS	O GDI recupera o formato bitfields da paleta de origem.
XO_SRCPALETTE	O GDI recupera cores RGB da paleta de origem.

cPal

Especifica o número de entradas no buffer apontado pelo pPal. Isso pode ser menor que o tamanho total da paleta.

pPal

Ponteiro para um buffer no qual a GDI grava as informações de paleta solicitadas. Se iPal for XO_SRCPALETTE ou XO_DESTPALETTE e o respectivo tipo de paleta for PAL_INDEXED, cada entrada será um valor RGB de 24 bits.

Se iPal for XO_SRCBITFIELDS ou XO_DESTBITFIELDS e o respectivo tipo de paleta for PAL_BITFIELDS, PAL_RGB ou PAL_BGR, o pPal apontará para três máscaras ULONG que representam as máscaras de cores vermelhas, verdes e azuis.

Retornar valor

XLATEOBJ_cGetPalette retorna o número de entradas gravadas se pPal não for nulo. Um valor zero será retornado se XLATEOBJ for nulo ou sua paleta for inválida. XLATEOBJ_cGetPalette também retornará zero se os dados apontados pelo pxlo não forem consistentes com o valor no iPal. Por exemplo, se os dados apontados forem um campo de bits, mas o iPal estiver definido como XO_SRCPALETTE ou XO_DESTPALETTE, XLATEOBJ_cGetPalette retornará zero. Da mesma forma, se os dados apontados por pxlo forem uma paleta, mas o iPal estiver definido como XO_SRCBITFIELDS ou XO_DESTBITFIELDS, XLATEOBJ_cGetPalette também retornará zero.

Comentários

O driver deve ter informações sobre a paleta para executar alguns métodos de mesclagem de cores.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino	Universal
Cabeçalho	winddi.h (inclua Winddi.h)
Biblioteca	Win32k.lib
DLL	Win32k.sys

Confira também

XLATEOBJ