Função EngQueryPalette (winddi.h)

A função EngQueryPalette consulta a paleta especificada para seus atributos.

Sintaxe

ENGAPI ULONG EngQueryPalette(
  HPALETTE hpal,
  ULONG    *piMode,
  ULONG    cColors,
  ULONG    *pulColors
);

Parâmetros

hpal

Manipule para a paleta a ser consultada.

piMode

Ponteiro para um local que recebe o modo de paleta, conforme especificado originalmente em EngCreatePalette.

cColors

Especifica o número de entradas no buffer para o qual pulColors aponta. O valor retornado depende se cColors é negativo.

pulColors

Ponteiro para um buffer que recebe as informações de cor da paleta. Se cColors for zero, pulColors poderá ser NULL.

Retornar valor

Quando cColors é zero, EngQueryPalette retorna o número de entradas de paleta necessárias no buffer para o qual pulColors aponta para retornar as informações de cor da paleta. Quando cColors é diferente de zero e pulColors não é NULL, EngQueryPalette retorna o número de entradas gravadas no buffer para o qual pulColors aponta.

Comentários

Se o modo de paleta for PAL_BITFIELDS, PAL_RGB ou PAL_BGR e o buffer para o qual pulColors aponta for grande o suficiente, pulColors apontará para três máscaras ULONG que representam as máscaras de cores vermelha, verde e azul da paleta.

Se o modo de paleta for PAL_INDEXED e o buffer para o qual pulColors aponta for grande o suficiente, pulColors conterá todos os valores RGB de 24 bits que representam as cores da paleta.

Um driver deve testar a presença do sinalizador GCAPS_PALMANAGED para determinar se as cores representam uma paleta fixa ou alterável.

EngQueryPalette destina-se ao uso por drivers de espelhamento que precisam saber o formato de cor da exibição primária. Um driver de espelhamento normalmente chama essa função em sua rotina DrvEnablePDEV .

Requisitos

Confira também

DrvEnablePDEV

EngCreatePalette