EndPage 函式 (wingdi.h)

EndPage函式會通知裝置應用程式已完成寫入頁面。 此函式通常用來指示設備磁碟機前進到新的頁面。

語法

int EndPage(
  [in] HDC hdc
);

參數

[in] hdc

列印工作之裝置內容的控制碼。

傳回值

如果函式成功，則傳回值大於零。

如果函式失敗，則傳回值小於或等於零。

備註

注意 這是封鎖或同步函式，可能不會立即傳回。 此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態和印表機驅動程式實作—撰寫應用程式時難以預測的因素。 從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。

 

如有必要，請使用 ResetDC 函式在呼叫 EndPage 函式之後變更裝置模式。 請注意， ResetDC 呼叫會將所有裝置內容屬性重設為預設值。 EndPage和StartPage都不會重設裝置內容屬性。 後續頁面的裝置內容屬性會維持不變。 您不需要重新選取物件，並在列印下一頁之前再次設定對應模式;不過，這樣做會產生相同的結果，並減少 Windows 版本之間的程式碼差異。

當多工緩衝處理檔案中的頁面超過大約 350 MB 時，它可能無法列印，而不會傳送錯誤訊息。 例如，列印大型 EMF 檔案時，可能會發生這種情況。 頁面大小限制取決於許多因素，包括可用的虛擬記憶體數量、呼叫進程所配置的記憶體數量，以及進程堆積中的片段數量。

範例

如需使用此函式的範例程式，請參閱 How To： Print Using the GDI Print API。

規格需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll

另請參閱

列印多工緩衝處理器 API 函式

列印

ResetDC

StartPage