openPrintProcessor 函式 (winsplp.h)

發行項
03/01/2024

列印處理器的 OpenPrintProcessor 函式會準備列印處理器以列印作業並傳回句柄。

語法

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

參數

[in] pPrinterName

呼叫端提供的指標，指向要開啟列印處理器的印表機名稱。

[in] pPrintProcessorOpenData

呼叫端提供的 PRINTPROCESSOROPENDATA 結構的指標。

傳回值

如果作業成功，函式應該會傳回句柄，以做為後續對 PrintDocumentOnPrintProcessor、ControlPrintProcessor 和 ClosePrintProcessor 呼叫的輸入自變數。如果作業失敗，函式應該呼叫 SetLastError 來設定錯誤碼，然後傳回 NULL。

備註

需要列印處理器才能匯出函 OpenPrintProcessor 式。當列印作業可用時，多任務緩衝處理程式會呼叫函式。函式應該根據作業的數據類型執行作業處理之前所需的初始化作業。

函式必須傳回句柄。一般而言，句柄是內部結構的指標。結構必須包含印表機名稱的指標，以及印表機 DEVMODEW 結構的指標，這兩者都是在 PRINTPROCESSOROPENDATA 結構中接收的。列印處理器的 PrintDocumentOnPrintProcessor 函式需要這兩個指標，而後者函式會在多任務緩衝處理器呼叫它時接收做為輸入的句柄。