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 | 驅動程式應該為裝置的原生預設色彩空間建立一個 dither。 例如，如果裝置在 16bpp 上執行，產生的 dither 格式應該是 16bpp。 |
| DM_MONOCHROME | 驅動程式應該為單色色彩空間建立兩者;也就是說，dpp 位圖應該傳回為 1bpp 位圖。 |
[in] rgb
指定要複製的 RGB 色彩。
[in, out] pul
接收任一信息之內存位置的指標。 記憶體必須已配置給標準格式位圖，其中具有 cyDither 的兩個筆刷維度 cxD。 這些維度是 DEVINFO 結構的成員。 位圖格式是由 DEVINFO 結構的 iDitherFormat 成員所決定。
傳回值
如果驅動程式已經計算出其中一個值，則傳回值會是DCR_DRIVER，DCR_SOLID如果引擎應該使用色彩的最佳純色近似值，或如果引擎應該為驅動程式建立半色調近似值，則DCR_HALFTONE。
備註
dul 的結果是一組儲存在 pul 中的裝置色彩索引。 針對其圖樣使用這些色彩所建立的筆刷應該是指定色彩 rgb 的良好近似值。
DrvDitherColor 是選擇性函式，只有在 cxDither 和 cyD 是 非零時才會呼叫。 單色設備驅動器，包括大部分的點陣印表機，都應該使用 iMode 參數來告訴 GDI 如何取得良好的灰階模式。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winddi.h (包含Winddi.h) |