HT_Get8BPPFormatPalette 函数 (winddi.h)

HT_Get8BPPFormatPalette函数返回半色调调色板,用于标准 8 位/像素设备类型。

语法

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

参数

[out] pPaletteEntry

指向MICROSOFT WINDOWS SDK文档) 中所述的 PALETTEENTRY 结构的数组的指针 (。 如果此指针不为 NULL,GDI 假定它指向有效的内存空间,GDI 可以在其中放置整个 8 位/像素半色调调色板。

[in] RedGamma

指定红色、绿色和蓝色伽玛值。 此 USHORT 值被解释为实数,其四个最小有效位位于 (隐式) 小数点的右侧。 例如,10000 的 gamma 值表示实数 1.0000,12345 表示 1.2345。 允许的最小伽玛值为 0.0000,最大允许值为 6.5535。

[in] GreenGamma

指定红色、绿色和蓝色伽玛值。 此 USHORT 值被解释为实数,其四个最小有效位位于 (隐式) 小数点的右侧。 例如,10000 的 gamma 值表示实数 1.0000,12345 表示 1.2345。 允许的最小伽玛值为 0.0000,最大允许值为 6.5535。

[in] BlueGamma

指定红色、绿色和蓝色伽玛值。 此 USHORT 值被解释为实数,其四个最小有效位位于 (隐式) 小数点的右侧。 例如,10000 的 gamma 值表示实数 1.0000,12345 表示 1.2345。 允许的最小伽玛值为 0.0000,最大允许值为 6.5535。

返回值

如果 pPaletteEntry 不为 NULL,则返回值是 GDI 从 pPaletteEntry 指向的内存位置开始填充的 PALETTEENTRY 结构的数目。 如果 pPaletteEntryNULL,则返回值是存储每像素半色调调色板 8 位所需的 PALETTEENTRY 结构的总计数。

注解

HT_Get8BPPFormatPalette 是半色调相关的 GDI 服务,驱动程序可以使用该服务获取系统的标准 8 位/像素半色调调色板。

要求

要求
最低受支持的客户端 适用于 Windows 2000 及更高版本的 Windows 操作系统。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys