EngDitherColor 函数 (winddi.h)
EngDitherColor 函数返回与指定 RGB 颜色近似的标准 8x8 抖动。
语法
ENGAPI ULONG EngDitherColor(
HDEV hdev,
ULONG iMode,
ULONG rgb,
ULONG *pul
);
参数
hdev
设备的句柄。 这是 GDI 传递给 DrvCompletePDEV 的句柄。
iMode
确定 GDI 应针对的调色板。 此参数可能是以下值之一：
| 值 | 含义 |
|---|---|
| DM_DEFAULT | 请求 GDI 为设备的本机默认颜色空间创建抖色。 例如，如果设备以 16bpp 的速度运行，则生成的 dither 采用 16bpp 格式。 |
| DM_MONOCHROME | 请求 GDI 为单色颜色空间创建抖动;也就是说，dither 作为 1bpp 位图返回。 |
rgb
指定要进行抖色的 RGB 颜色。 GDI 忽略此 ULONG 值的高字节。
pul
指向 GDI 返回抖讯信息的内存位置的指针。 驱动程序必须为具有 8x8 的抖动画笔尺寸的标准格式位图分配内存。 驱动程序还必须将 DEVINFO 结构的 cxDither 和 cyDither 成员设置为 8。
返回值
如果已由驱动程序计算了抖动值，则返回值DCR_DRIVER;如果引擎应使用颜色的最佳纯色近似值，则返回值DCR_SOLID。
备注
可以为 8bpp 或更高的位图调用 EngDitherColor。
要求
| 最低受支持的客户端 | 在 Windows 2000 及更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 通用 |
| 标头 | winddi.h (包括 Winddi.h) |
| Library | Win32k.lib |
| DLL | Win32k.sys |