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 を呼び出す必要はありません。

要件

こちらもご覧ください

BRUSHOBJ

BRUSHOBJ_pvAllocRbrush

DrvRealizeBrush