Поделиться через

функция HT_Get8BPPFormatPalette (winddi.h)

  • Статья

Функция HT_Get8BPPFormatPalette возвращает полутоновую палитру для стандартных типов устройств с 8 битами на пиксель.

Синтаксис

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

Параметры

[out] pPaletteEntry

Указатель на массив структур PALETTEENTRY (описано в документации по Microsoft Windows SDK). Если этот указатель не равен NULL, GDI предполагает, что он указывает на допустимое пространство памяти, в котором GDI может разместить всю 8-битовую палитру полутонов пикселей.

[in] RedGamma

Задает красное, зеленое и синее гамма-значение. Это значение USHORT интерпретируется как реальное число, четыре наименее значимые цифры которого находятся справа от (подразумеваемой) десятичной запятой. Например, гамма-значение 10000 представляет собой реальное число 1,0000, а 12345 — 1,2345. Минимально допустимое гамма-значение — 0,0000, а максимально допустимое значение — 6,5535.

[in] GreenGamma

Задает красное, зеленое и синее гамма-значение. Это значение USHORT интерпретируется как реальное число, четыре наименее значимые цифры которого находятся справа от (подразумеваемой) десятичной запятой. Например, гамма-значение 10000 представляет собой реальное число 1,0000, а 12345 — 1,2345. Минимально допустимое гамма-значение — 0,0000, а максимально допустимое значение — 6,5535.

[in] BlueGamma

Задает красное, зеленое и синее гамма-значение. Это значение USHORT интерпретируется как реальное число, четыре наименее значимые цифры которого находятся справа от (подразумеваемой) десятичной запятой. Например, гамма-значение 10000 представляет собой реальное число 1,0000, а 12345 — 1,2345. Минимально допустимое гамма-значение — 0,0000, а максимально допустимое значение — 6,5535.

Возвращаемое значение

Если pPaletteEntry не равно NULL, возвращаемое значение — это количество структур PALETTEENTRY, заполненных GDI, начиная с расположения памяти, на которое указывает pPaletteEntry. Если pPaletteEntry имеет значение NULL, возвращаемое значение — это общее количество структур PALETTEENTRY, необходимых для хранения 8-разрядных значений на палитру полутонов пикселей.

Комментарии

HT_Get8BPPFormatPalette — это служба GDI, связанная с полутонами, которую драйверы могут использовать для получения стандартной 8-разрядной палитры системных полутонов на пиксель.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys