printDocumentOnPrintProcessor 函式 (winsplp.h)
列印處理器的 PrintDocumentOnPrintProcessor 函式會將列印作業從多任務緩衝處理格式轉換成可傳送至列印監視器的原始數據。
語法
BOOL PrintDocumentOnPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] LPWSTR pDocumentName
);
參數
[in] hPrintProcessor
呼叫端提供的列印處理器句柄。 這是先前呼叫 OpenPrintProcessor 所傳回的句柄。
[in] pDocumentName
呼叫端提供的文件名稱指標。
傳回值
如果作業成功，函式應該會傳回 TRUE。 如果作業失敗，函式應該呼叫 SetLastError 來設定錯誤碼，然後傳回 FALSE。
備註
需要列印處理器才能匯出函 PrintDocumentOnPrintProcessor 式。 多任務緩衝處理程式會在呼叫 OpenPrintProcessor 之後呼叫 函式。 函式的目的是讀取 pDocumentName 所命名的檔案內容、視需要) 將 (轉換成可由印表機硬體讀取的數據流，並將數據流傳回多任務緩衝處理器。 然後，多任務緩衝處理程式可以將數據流傳送至適當的 列印監視器。
如果輸入格式是 NT 型作業系統 EMF，函 PrintDocumentOnPrintProcessor 式可以呼叫 列印處理器的 GDI 函數。 如需詳細資訊，請參閱 處理列印作業。
轉換后的數據流必須藉由呼叫 WritePrinter 來傳回多任務緩衝處理程式，如 Microsoft Windows SDK 檔中所述。 如需詳細資訊，請參閱 處理列印作業。
必須寫入函 PrintDocumentOnPrintProcessor 式來處理暫停、繼續或取消列印作業的要求。 如需詳細資訊，請參閱 ControlPrintProcessor。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | winsplp.h (包含 Winsplp.h) |
| 程式庫 | Nwprint.lib |