Função DrvSetPalette (winddi.h)

Artigo
03/13/2024

A função DrvSetPalette solicita que o driver perceba a paleta de um dispositivo especificado.

Sintaxe

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

Parâmetros

dhpdev

Manipule para a estrutura PDEV do dispositivo físico, que identifica o dispositivo cuja paleta deve ser realizada. Esse parâmetro é o identificador de dispositivo retornado ao GDI por DrvEnablePDEV.

ppalo

Ponteiro para a estrutura PALOBJ da qual as cores (valores RGB) devem ser consultadas.

fl

Um conjunto de sinalizadores que fornece dicas e opções. Esse parâmetro pode ser o seguinte valor:

Valor	Significado
SP_DEFAULT	A paleta é a paleta padrão completa do dispositivo. O PALOBJ pode ser ignorado, mas contém o conteúdo correto.

iStart

Especifica o primeiro índice de paleta a ser substituído.

cColors

Especifica o número de cores a serem alteradas na paleta de hardware. Cores extras, além do número disponível no hardware, podem ser ignoradas. Se cColors for menor que o tamanho da paleta de hardware, defina apenas as entradas cColors e deixe as cores restantes como estão.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida. Caso contrário, será FALSE e um código de erro será registrado.

Comentários

O driver define a paleta de hardware para corresponder as entradas na paleta especificada o mais próximo possível.

Somente paletas indexadas são realizaveis. O RC_PALETTE bit do membro flRasterCaps da estrutura GDIINFO especifica se um dispositivo tem uma paleta realizavel.

DrvSetPalette é necessário para drivers de exibição que dão suporte a paletas realizaveis.