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且 pulColors 指向的緩衝區夠大， pulColors 就會包含代表調色盤色彩的所有 24 位 RGB 值。
驅動程式必須測試是否有GCAPS_PALMANAGED旗標，以判斷色彩是否代表固定或可變更的調色盤。
EngQueryPalette 適用於需要知道主要顯示器色彩格式的鏡像驅動程式。 鏡像驅動程式通常會在其 DrvEnablePDEV 例程中呼叫此函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
| 目標平台 | Universal |
| 標頭 | winddi.h (包含Winddi.h) |
| 程式庫 | Win32k.lib |
| Dll | Win32k.sys |