drvSetPalette 函数 (winddi.h)

DrvSetPalette 函数请求驱动程序实现指定设备的调色板。

语法

BOOL DrvSetPalette(
  DHPDEV dhpdev,
  PALOBJ *ppalo,
  FLONG  fl,
  ULONG  iStart,
  ULONG  cColors
);

dhpdev

物理设备的 PDEV 结构的句柄，该结构标识要实现其调色板的设备。此参数是 DrvEnablePDEV 返回到 GDI 的设备句柄。

ppalo

指向 PALOBJ 结构的指针，应从中查询 (RGB 值) 的颜色。

fl

一组提供提示和选项的标志。此参数可以是以下值：

值	含义
SP_DEFAULT	调色板是设备的完整默认调色板。可以忽略 PALOBJ ，但包含正确的内容。

iStart

指定要覆盖的第一个调色板索引。

cColors

指定要在硬件调色板中更改的颜色数。超出硬件中可用数量的额外颜色可以忽略。如果 cColors 小于硬件调色板的大小，请仅设置 cColors 条目，并保留其余颜色。

如果函数成功，则返回值为 TRUE 。否则，它为 FALSE，并记录错误代码。

驱动程序将硬件面板设置为尽可能与给定调色板中的条目匹配。

只能实现索引调色板。 GDIINFO 结构的 flRasterCaps 成员的 RC_PALETTE 位指定设备是否具有可实现的调色板。

支持可实现调色板的显示驱动程序需要 DrvSetPalette。

要求	值
目标平台	桌面
标头	winddi.h (包括 Winddi.h)