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 オペレーティング システムで使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | winddi.h (Winddi.h を含む) |
| Library | Win32k.lib |
| [DLL] | Win32k.sys |