ホーム › Devices.Display › PFN_DrvQueryPerBandInfo

PFN_DrvQueryPerBandInfo

コールバック

シグネチャ

BOOL PFN_DrvQueryPerBandInfo(
    SURFOBJ* param0,
    PERBANDINFO* param1
);

パラメーター

フィールド	型
param0	SURFOBJ*
param1	PERBANDINFO*

公式ドキュメント

プリンターグラフィックス DLL の DrvQueryPerBandInfo 関数は、GDI が物理ページのバンドの描画を開始する前に呼び出され、ドライバーがバンド固有の情報を GDI に提供できるようにします。

戻り値

この関数は、次のいずれかの値を返す必要があります。

戻り値	説明
0 より大きい値	GDI は PERBANDINFO 構造体の内容を使用します。
0	GDI は PERBANDINFO 構造体の内容を無視します。
DDI_ERROR	GDI はバンドを描画しません。

解説(Remarks)

プリンターグラフィックス DLL が GDI 管理のサーフェスを使用し、かつサーフェスのバンディングをサポートしている場合、DrvQueryPerBandInfo 関数を任意で提供できます。GDI は、各バンドをレンダリングする前にこの関数を呼び出します。

プリンターグラフィックス DLL は、この関数の PERBANDINFO 構造体を使用して、直前のバンドを再描画する必要があるかどうかを示し、またバンドをスケーリングすることを指定します。プリンターグラフィックス DLL がバンディングをサポートしていても DrvQueryPerBandInfo 関数を提供しない場合、GDI はバンドの繰り返しやスケーリングを行いません。

DrvQueryPerBandInfo 関数は、EMF ファイルの再生中にのみ呼び出されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)