PFN_DrvEndDoc

コールバック

シグネチャ

BOOL PFN_DrvEndDoc(
    SURFOBJ* pso,
    DWORD fl
);

パラメーター

フィールド

型

説明

pso

SURFOBJ*

呼び出し元が指定する SURFOBJ 構造体へのポインターです。

DWORD

呼び出し元が指定するビットフラグのセットです。次のフラグが定義されています。

フラグ	定義
ED_ABORTDOC	印刷ジョブが完了前に終了されます。

公式ドキュメント

DrvEndDoc 関数は、GDI がレンダリングのためのドキュメントの送信をドライバーに対して完了したときに呼び出されます。

戻り値

操作が成功した場合、この関数は TRUE を返します。それ以外の場合は SetLastError を呼び出してエラーコードを設定し、FALSE を返します。

解説(Remarks)

プリンターグラフィックス DLL は、DrvEndDoc 関数を提供する必要があります。この関数は、印刷ジョブの最後の物理ページがレンダリングされた後に呼び出されます。

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

印刷ジョブの終了時にプリンターグラフィックス DLL が個別に呼び出されることはないため、プリンター側で必要とされる場合は、DrvEndDoc 関数がジョブを終了するための制御シーケンスもプリンターに送信する必要があります。(言い換えると、1 つのジョブにつきドキュメントは 1 つです。)

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