HT_Get8BPPFormatPalette

LONG HT_Get8BPPFormatPalette(

LPPALETTEENTRY pPaletteEntry,
USHORT RedGamma,
USHORT GreenGamma,
USHORT BlueGamma
);

HT_Get8BPPFormatPalette returns a halftone palette for use on standard 8-bits per pixel device types.

Parameters

pPaletteEntry

Points to an array of PALETTEENTRY structures. When this pointer is not null, GDI assumes that it points to valid memory space in which GDI can place the 8-bits per pixel halftone palette.

RedGamma, GreenGamma, BlueGamma

Specify the red, green, and blue gamma values. These USHORT values are interpreted as real numbers whose four least-significant digits are decimal points. For example, a gamma value of 10000 represents the real number 1.0000, and 12345 represents 1.2345. The minimum gamma value allowed is 0.0000, and the maximum allowable value is 6.5535.

Return Value

If pPaletteEntry is not null, the return value is the number of PALETTEENTRY structures written to the memory location pointed to by pPaletteEntry. If pPaletteEntry is null, the return value is the total count of PALETTEENTRY structures required to store the 8-bits per pixel halftone palette.

Comments

HT_Get8BPPFormatPalette is a halftone-related GDI service that drivers can use to acquire the system’s standard 8-bits per pixel halftone palette.