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)

另請參閱

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvEnablePDEV

XLATEOBJ