BRUSHOBJ_pvGetRbrush函式 (winddi.h)

BRUSHOBJ_pvGetRbrush函式會擷取驅動程序實現指定筆刷的指標。

語法

ENGAPI PVOID BRUSHOBJ_pvGetRbrush(
  BRUSHOBJ *pbo
);

參數

pbo

要求實現的 BRUSHOBJ 結構的指標。

傳回值

如果函式成功,傳回值是實現筆刷的指標。 如果筆刷無法實現,則傳回值為 Null,並記錄錯誤碼。

備註

筆刷是尚未實現的圖樣筆刷時,就會呼叫BRUSHOBJ_pvGetRbrush;也就是說,當 BRUSHOBJ 結構的 iSolidColor 成員0xFFFFFFFF且 pvRbrush 成員為 null 時,就會呼叫它。

如果在呼叫 BRUSHOBJ_pvGetRbrush 時尚未實現筆刷,GDI 會呼叫驅動程式提供的 DrvRealizeBrush 函式,以取得驅動程式的筆刷實現。 GDI 會在 BRUSHOBJ 結構的 pvRbrush 成員中快取這項實現。 然後,當應用程式針對另一個繪圖作業重複使用此筆刷時,驅動程式不需要再次呼叫 BRUSHOBJ_pvGetRbrush

規格需求

需求
最低支援的用戶端 適用於 Windows 2000 和更新版本的 Windows 作業系統。
目標平台 Universal
標頭 winddi.h (包含Winddi.h)
程式庫 Win32k.lib
Dll Win32k.sys

另請參閱

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush