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

PFN_DrvSendPage

コールバック

シグネチャ

BOOL PFN_DrvSendPage(
    SURFOBJ* param0
);

パラメーター

フィールド型
param0SURFOBJ*

公式ドキュメント

プリンターグラフィックス 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)