drvDitherColor 函数 (winddi.h)
DrvDitherColor 函数请求设备创建针对设备调色板抖色的画笔。
语法
ULONG DrvDitherColor(
[in] DHPDEV dhpdev,
[in] ULONG iMode,
[in] ULONG rgb,
[in, out] ULONG *pul
);
参数
[in] dhpdev
描述物理设备的 PDEV 结构的句柄，其调色板应以指定颜色进行抖色。
[in] iMode
确定要针对的调色板。 此参数可能是以下值之一：
| 值 | 含义 |
|---|---|
| DM_DEFAULT | 驱动程序应为设备的本机默认颜色空间创建抖动。 例如，如果设备以 16bpp 的速度运行，则生成的抖响应采用 16bpp 格式。 |
| DM_MONOCHROME | 驱动程序应为单色颜色空间创建抖动;也就是说，dither 应作为 1bpp 位图返回。 |
[in] rgb
指定要进行抖色的 RGB 颜色。
[in, out] pul
指向接收抖讯信息的内存位置的指针。 必须已为具有抖线画笔尺寸 cxDither 的标准格式位图分配内存。 这些维度是 DEVINFO 结构的成员。 位图格式由 DEVINFO 结构的 iDitherFormat 成员决定。
返回值
如果已由驱动程序计算了抖动值，则返回值DCR_DRIVER;DCR_SOLID引擎是否应使用颜色的最佳纯色近似值;如果引擎应为驱动程序创建半色调近似值，则返回值DCR_HALFTONE。
注解
dither 的结果是存储在 pul 中的一组设备颜色索引。 使用这些颜色为其图案创建的画笔应是给定颜色 rgb 的良好近似值。
DrvDitherColor 是一个可选函数，仅在 cxDither 和 cyDither 为非零时调用。 单色设备驱动程序（包括大多数光栅打印机）应使用 iMode 参数告知 GDI 如何获取良好的灰度模式。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | winddi.h (包括 Winddi.h) |