DrvSetPalette 函式 (winddi.h)
DrvSetPalette 函式會要求驅動程式實現指定裝置的調色盤。
語法
BOOL DrvSetPalette(
DHPDEV dhpdev,
PALOBJ *ppalo,
FLONG fl,
ULONG iStart,
ULONG cColors
);
參數
dhpdev
實體裝置 的 PDEV 結構句柄，可識別要實現調色盤的裝置。 此參數是 DrvEnablePDEV傳回至 GDI 的裝置句柄。
ppalo
應從中查詢 RGB 值 (色彩) PALOBJ 結構的指標。
fl
一組旗標，提供提示和選項。 此參數可以是下列值：
| 值 | 意義 |
|---|---|
| SP_DEFAULT | 調色盤是裝置的完整預設調色盤。 您可以忽略 PALOBJ，但包含正確的內容。 |
iStart
指定要覆寫的第一個調色盤索引。
cColors
指定要在硬體調色盤中變更的色彩數目。 除了硬體中可用的數位之外，可以忽略額外的色彩。 如果 cColors 小於硬體調色盤的大小，請只設定 cColors 專案，並保留其餘色彩。
傳回值
如果函式成功，則傳回值為 TRUE 。 否則，它會是 FALSE，並記錄錯誤碼。
備註
驅動程式會將硬體選擇區設定為盡可能符合指定調色盤中的專案。
只有索引調色盤可實現。 GDIINFO 結構的 flRasterCaps 成員RC_PALETTE位會指定裝置是否有可實現的調色盤。
支援可實現調色盤的顯示驅動程式需要DrvSetPalette。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winddi.h (包括 Winddi.h) |