Win32 API 日本語リファレンス
ホーム › Devices.Display › PFN_DrvStartPage

PFN_DrvStartPage

コールバック

シグネチャ

BOOL PFN_DrvStartPage(
    SURFOBJ* pso
);

パラメーター

フィールド型説明
psoSURFOBJ*呼び出し元が指定する SURFOBJ 構造体へのポインターです。

公式ドキュメント

DrvStartPage 関数は、物理ページの内容をレンダリングのためにドライバーへ送り始める準備が整ったときに、GDI によって呼び出されます。

戻り値

処理が成功した場合、この関数は TRUE を返します。失敗した場合は、Win32 の SetLastError 関数を呼び出してエラーコードを設定し、FALSE を返します。

解説(Remarks)

プリンターグラフィックス DLL は、DrvStartPage 関数を提供する必要があります。この関数は、印刷ジョブの各物理ページがレンダリングされる前に呼び出されます (1 つの物理ページには、1 つ以上のドキュメントページを含めることができます)。

通常、この関数は、ページが印刷される前に GDI の EngWritePrinter 関数を呼び出して、プリンターハードウェアに制御シーケンスを送るために使用されます。また、プリンターグラフィックス DLL 内部の、ページ固有の初期化処理を行うこともできます。

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