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)