EndPage

EndPage 関数は、アプリケーションがページへの書き込みを終えたことをデバイスに通知する。この関数は通常、デバイスドライバに新しいページへ進むよう指示するために使用する。

EndPage hdc

hdc : [intptr] 印刷ジョブのデバイスコンテキストへのハンドル。

(プラグイン / モジュール : gdi32.dll)

解説

EndPage
関数は、アプリケーションがページへの書き込みを終えたことをデバイスに通知する。この関数は通常、デバイスドライバに新しいページへ進むよう指示するために使用する。

[戻り値]
関数が成功した場合、戻り値はゼロより大きい値となる。関数が失敗した場合、戻り値はゼロ以下となる。

[備考]
注意:
これはブロッキングまたは同期関数であり、即座に戻らないことがある。この関数がどれくらい速く戻るかは、ネットワーク状態、プリントサーバーの構成、プリンタードライバーの実装といった、アプリケーション作成時には予測しにくい実行時要因に依存する。ユーザーインターフェイスとのやり取りを管理するスレッドからこの関数を呼び出すと、アプリケーションが応答しなくなったように見えることがある。EndPage
の呼び出し後に必要があれば、ResetDC を使ってデバイスモードを変更する。ResetDC
を呼ぶとすべてのデバイスコンテキスト属性がデフォルト値にリセットされることに注意。EndPage と StartPage
はデバイスコンテキスト属性をリセットしない。デバイスコンテキスト属性は次のページにわたって一定に保たれる。次のページを印刷する前にオブジェクトを再選択したりマッピングモードを再設定したりする必要はない。ただし、そうすることで結果は同じになり、Windows
のバージョン間のコード差異を減らせる。スプールファイル内のページが約 350 MB
を超えると、エラーメッセージなしに印刷が失敗することがある。例えば大きな EMF
ファイルを印刷する場合に発生し得る。ページサイズの上限は、利用可能な仮想メモリ量、呼び出し元プロセスが割り当てているメモリ量、プロセスヒープの断片化の度合いなど、多くの要因に依存する。

情報