DrvQueryPerBandInfo 関数 (winddi.h)
プリンター グラフィックス DLL の DrvQueryPerBandInfo 関数は、ドライバーが GDI にバンド固有の情報を提供できるように、物理ページのバンドの描画を開始する前に GDI によって呼び出されます。
構文
ULONG DrvQueryPerBandInfo(
[in] SURFOBJ *pso,
[in, out] PERBANDINFO *pbi
);
パラメーター
[in] pso
描画サーフェイスを記述する SURFOBJ 構造体への呼び出し元指定のポインター。
[in, out] pbi
関数が上書きできる既定の情報を含む PERBANDINFO 構造体への呼び出し元指定のポインター。
戻り値
関数は、次のいずれかの値を返す必要があります。
リターン コード | 説明 |
---|---|
|
GDI は PERBANDINFO 構造体の内容を使用します。 |
|
GDI は PERBANDINFO 構造体の内容を無視します。 |
|
GDI はバンドを描画しません。 |
解説
プリンター グラフィックス DLL で GDI で管理されるサーフェスが使用され、サーフェス バンディングがサポートされている場合は、必要に応じて DrvQueryPerBandInfo 関数を提供できます。 GDI は、各バンドをレンダリングする前に 関数を呼び出します。
プリンター グラフィックス DLL では、関数の PERBANDINFO 構造体を使用して、前のバンドを再描画するかどうかを示し、バンドをスケーリングするように指定します。 プリンター グラフィックス DLL がバンディングをサポートしていても 、DrvQueryPerBandInfo 関数を提供しない場合、GDI はバンドを繰り返したりスケールしたりしません。
DrvQueryPerBandInfo 関数は、EMF ファイルの再生中にのみ呼び出されます。
要件
対象プラットフォーム | デスクトップ |
Header | winddi.h (Winddi.h を含む) |