Função HT_Get8BPPFormatPalette (winddi.h)

A função HT_Get8BPPFormatPalette retorna uma paleta de meio tom para uso em tipos de dispositivo padrão de 8 bits por pixel.

Sintaxe

LONG HT_Get8BPPFormatPalette(
  [out] LPPALETTEENTRY pPaletteEntry,
  [in]  USHORT         RedGamma,
  [in]  USHORT         GreenGamma,
  [in]  USHORT         BlueGamma
);

Parâmetros

[out] pPaletteEntry

Ponteiro para uma matriz de estruturas PALETTEENTRY (descrita na documentação do SDK do Microsoft Windows). Quando esse ponteiro não é NULL, a GDI pressupõe que aponta para um espaço de memória válido no qual o GDI pode colocar toda a paleta de 8 bits por pixel de meio tom.

[in] RedGamma

Especifica o valor gama vermelho, verde e azul. Esse valor ushort é interpretado como um número real cujos quatro dígitos menos significativos estão à direita do ponto decimal (implícito). Por exemplo, um valor gama de 10000 representa o número real 1,0000 e 12345 representa 1,2345. O valor mínimo de gama permitido é 0,0000 e o valor máximo permitido é 6,5535.

[in] GreenGamma

Especifica o valor gama vermelho, verde e azul. Esse valor ushort é interpretado como um número real cujos quatro dígitos menos significativos estão à direita do ponto decimal (implícito). Por exemplo, um valor gama de 10000 representa o número real 1,0000 e 12345 representa 1,2345. O valor mínimo de gama permitido é 0,0000 e o valor máximo permitido é 6,5535.

[in] BlueGamma

Especifica o valor gama vermelho, verde e azul. Esse valor ushort é interpretado como um número real cujos quatro dígitos menos significativos estão à direita do ponto decimal (implícito). Por exemplo, um valor gama de 10000 representa o número real 1,0000 e 12345 representa 1,2345. O valor mínimo de gama permitido é 0,0000 e o valor máximo permitido é 6,5535.

Retornar valor

Se pPaletteEntry não for NULL, o valor retornado será o número de estruturas PALETTEENTRY que a GDI preencheu começando no local de memória apontado por pPaletteEntry. Se pPaletteEntry for NULL, o valor retornado será a contagem total de estruturas PALETTEENTRY necessárias para armazenar a paleta de meio tom de 8 bits por pixel.

Comentários

HT_Get8BPPFormatPalette é um serviço GDI relacionado a meio tom que os drivers podem usar para adquirir a paleta padrão de 8 bits por meio tom de pixel do sistema.

Requisitos