EngQueryPalette 函数 (winddi.h)
EngQueryPalette 函数查询其属性的指定调色板。
语法
ENGAPI ULONG EngQueryPalette(
HPALETTE hpal,
ULONG *piMode,
ULONG cColors,
ULONG *pulColors
);
参数
hpal
要查询的调色板的句柄。
piMode
指向接收调色板模式的位置的指针，该模式最初在 EngCreatePalette 中指定。
cColors
指定 pulColors 指向的缓冲区中的条目数。 返回值取决于 cColors 是否为负值。
pulColors
指向接收调色板颜色信息的缓冲区的指针。 如果 cColors 为零， 则 pulColors 可以为 NULL。
返回值
当 cColors 为零时， EngQueryPalette 返回 pulColors 指向的缓冲区中为了返回调色板颜色信息所需的调色板条目数。 当 cColors 为非零值且 pulColors 不为 NULL 时， EngQueryPalette 将返回 pulColors 指向的缓冲区中写入的条目数。
注解
如果调色板模式PAL_BITFIELDS、PAL_RGB或PAL_BGR，并且 pulColors 指向的缓冲区足够大， 则 pulColors 指向表示调色板的红色、绿色和蓝色蒙板的三个 ULONG 掩码。
如果调色板模式PAL_INDEXED并且 pulColor 指向 的缓冲区足够大， 则 pulColors 包含表示调色板颜色的所有 24 位 RGB 值。
驱动程序必须测试是否存在GCAPS_PALMANAGED标志，以确定颜色是表示固定调色板还是可更改调色板。
EngQueryPalette 适用于需要知道主显示器颜色格式的镜像驱动程序。 镜像驱动程序通常在其 DrvEnablePDEV 例程中调用此函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 2000 及更高版本的 Windows 操作系统。 |
| 目标平台 | 通用 |
| 标头 | winddi.h (包括 Winddi.h) |
| Library | Win32k.lib |
| DLL | Win32k.sys |