StartDocPrinter 函式

  • 發行項

StartDocPrinter函式會通知列印多工緩衝處理器檔要多工緩衝處理以進行列印。

語法

DWORD StartDocPrinter(
  _In_ HANDLE hPrinter,
  _In_ DWORD  Level,
  _In_ LPBYTE pDocInfo
);

參數

hPrinter [in]

印表機的控制碼。 使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。

層級 [in]

pDocInfo指向的結構版本。 此值必須是 1。

pDocInfo [in]

描述要列印之檔 之DOC_INFO_1 結構的指標。

傳回值

如果函式成功，傳回值會識別列印工作。

如果此函式失敗，則傳回值為零。

備註

注意

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

列印工作的典型順序如下：

  1. 若要開始列印工作，請呼叫 StartDocPrinter。
  2. 若要開始每個頁面，請呼叫 StartPagePrinter。
  3. 若要將資料寫入頁面，請呼叫 WritePrinter。
  4. 若要結束每個頁面，請呼叫 EndPagePrinter。
  5. 視需要針對多個頁面重複 2、3 和 4。
  6. 若要結束列印工作，請呼叫 EndDocPrinter。

請注意，可能不需要呼叫 StartPagePrinter 和 EndPagePrinter ，例如列印資料類型是否包含頁面資訊。

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

範例

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

規格需求

需求 值
最低支援的用戶端
 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限桌面應用程式]
標頭
Winspool.h (包含 Windows.h)
程式庫
Winspool.lib
DLL
Winspool.drv
Unicode 與 ANSI 名稱
 StartDocPrinterW (Unicode) 和 StartDocPrinterA (ANSI)

另請參閱

AddJob

DOC_INFO_1

DOC_INFO_2

EndDocPrinter

EndPagePrinter

OpenPrinter

列印

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

StartDocPrinter

StartPagePrinter

WritePrinter