función HT_Get8BPPFormatPalette (winddi.h)

La función HT_Get8BPPFormatPalette devuelve una paleta de media tono para su uso en tipos de dispositivo estándar de 8 bits por píxel.

Sintaxis

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

Parámetros

[out] pPaletteEntry

Puntero a una matriz de estructuras PALETTEENTRY (descritas en la documentación de Microsoft Windows SDK). Cuando este puntero no es NULL, GDI supone que apunta a un espacio de memoria válido en el que GDI puede colocar todos los 8 bits por paleta de medio tono de píxel.

[in] RedGamma

Especifica el valor gamma rojo, verde y azul. Este valor de USHORT se interpreta como un número real cuyos cuatro dígitos menos significativos están a la derecha del separador decimal (implícito). Por ejemplo, un valor gamma de 10000 representa el número real 1,0000 y 12345 representa 1,2345. El valor gamma mínimo permitido es 0,0000 y el valor máximo permitido es 6,5535.

[in] GreenGamma

Especifica el valor gamma rojo, verde y azul. Este valor de USHORT se interpreta como un número real cuyos cuatro dígitos menos significativos están a la derecha del separador decimal (implícito). Por ejemplo, un valor gamma de 10000 representa el número real 1,0000 y 12345 representa 1,2345. El valor gamma mínimo permitido es 0,0000 y el valor máximo permitido es 6,5535.

[in] BlueGamma

Especifica el valor gamma rojo, verde y azul. Este valor de USHORT se interpreta como un número real cuyos cuatro dígitos menos significativos están a la derecha del separador decimal (implícito). Por ejemplo, un valor gamma de 10000 representa el número real 1,0000 y 12345 representa 1,2345. El valor gamma mínimo permitido es 0,0000 y el valor máximo permitido es 6,5535.

Valor devuelto

Si pPaletteEntry no es NULL, el valor devuelto es el número de estructuras PALETTEENTRY que GDI rellena a partir de la ubicación de memoria a la que apunta pPaletteEntry. Si pPaletteEntry es NULL, el valor devuelto es el recuento total de estructuras PALETTEENTRY necesarias para almacenar la paleta de 8 bits por medio de píxeles.

Comentarios

HT_Get8BPPFormatPalette es un servicio GDI relacionado con el medio tono que los controladores pueden usar para adquirir la paleta estándar de 8 bits por medio de píxeles del sistema.

Requisitos