ホーム › Devices.Display › PFN_DrvSendPage
PFN_DrvSendPage
コールバックシグネチャ
BOOL PFN_DrvSendPage(
SURFOBJ* param0
);パラメーター
| フィールド | 型 |
|---|---|
| param0 | SURFOBJ* |
公式ドキュメント
プリンターグラフィックス DLL の DrvSendPage 関数は、GDI が物理ページの描画を終えたときに GDI から呼び出されます。これにより、ドライバーはそのページをプリンターへ送信できます。
戻り値
処理が成功した場合、この関数は TRUE を返します。それ以外の場合は、Win32 の SetLastError 関数を呼び出してエラーコードを設定し、FALSE を返します。
解説(Remarks)
GDI は、描画サーフェス上に物理ページのイメージを描き終えるたびに DrvSendPage を呼び出します。この関数は、EngWritePrinter を呼び出してイメージをプリンターへ送信し、ページの排出などのページ終了処理を実行する責任があります。
GDI 管理サーフェスを使用するプリンターグラフィックス DLL は通常、バンド単位で処理されるページについては、各バンドのイメージをドライバーの DrvNextBand 関数がプリンターへ送信するように実装されます。
さらに、プリンターグラフィックス DLL がデバイス管理サーフェスを使用している場合、イメージは描画と同時にプリンターへ送信されるため、DrvSendPage 関数は通常、ページ終了処理を実行するだけで済みます。
この関数の実行に長い時間がかかる可能性がある場合は、5 秒ごとに EngCheckAbort を呼び出す必要があります。EngCheckAbort が TRUE を返した場合、DrvSendPage は処理を中止して FALSE を返す必要があります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)