DrvRealizeBrush 函式 (winddi.h)
DrvRealizeBrush 函式會要求驅動程式為指定的表面實現指定的筆刷。
語法
BOOL DrvRealizeBrush(
[in] BRUSHOBJ *pbo,
[in, out] SURFOBJ *psoTarget,
[in] SURFOBJ *psoPattern,
[in, optional] SURFOBJ *psoMask,
[in] XLATEOBJ *pxlo,
[in] ULONG iHatch
);
參數
[in] pbo
要實現之 BRUSHOBJ 結構的指標。 除了 psoTarget 以外，所有其他參數都可以從這個對象查詢。 參數規格是以優化方式提供。 此參數最適合用來做為 BRUSHOBJ_pvAllocRbrush的參數，這會為實現的筆刷配置記憶體。
[in, out] psoTarget
要實現筆刷之 SURFOBJ 結構的指標。 此表面可以是裝置的實體表面、裝置格式位圖或標準格式位圖。
[in] psoPattern
描述筆刷模式之 SURFOBJ 結構的指標。 對於點陣裝置，這是位圖。 對於向量裝置，這是 DrvEnablePDEV所提供的其中一個模式介面。
[in, optional] psoMask
描述筆刷透明度遮罩之 SURFOBJ 結構的指標。 這是每個圖元陣圖的1位，其範圍與圖樣相同。 零的遮罩表示圖元會被視為筆刷的背景圖元。 (在透明背景模式中，背景圖元在 fill.) Plotter 中不會受到影響，因為永遠不會繪製背景資訊，所以可以忽略此參數。
[in] pxlo
XLATEOBJ 結構的指標，定義模式中色彩的解譯。 如果 pxlo 為 NULL，則不需要翻譯。 您可以呼叫 XLATEOBJ_Xxx 服務例程，將色彩轉譯為裝置色彩索引。 向量裝置應該透過 XLATEOBJ 轉譯色彩零，以取得筆刷的前景色彩。
[in] iHatch
指定 psoPattern 是否為 DrvEnablePDEV 所傳回的影線筆刷之一。 如果此參數的值小於 winddi.h中定義的 HS_DDI_MAX，則為 true。
傳回值
如果筆刷已成功實現，則傳回值為 TRUE 。 否則，它會是 FALSE，並記錄錯誤碼。
備註
為了瞭解筆刷，驅動程式會將 GDI 筆刷轉換成可在內部使用的表單。 實現的筆刷包含裝置使用筆刷加速繪製所需的裝置特定資訊。
驅動程式的筆刷實現會寫入呼叫所配置的緩衝區 BRUSHOBJ_pvAllocRbrush。
驅動程式需要DrvRealizeBrush 才能對任何表面進行任何繪圖。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winddi.h (包括 Winddi.h) |