ControlPrintProcessor 函式 (winsplp.h)
列印處理器的 ControlPrintProcessor 函式可讓多任務緩衝處理器控制列印作業。
語法
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
參數
[in] hPrintProcessor
呼叫端提供的列印處理器句柄。 這是先前呼叫 openPrintProcessor 所傳回的句柄。
[in] Command
呼叫端提供的命令,指出要執行的作業類型。 下列命令有效:
命令 | 定義 |
---|---|
JOB_CONTROL_CANCEL | 函式應該會取消目前的列印作業。 |
JOB_CONTROL_PAUSE | 函式應該會暫停目前的列印作業。 |
JOB_CONTROL_RESUME | 函式應該會繼續目前的列印作業。 |
傳回值
如果工作成功,函式應該 TRUE傳回 。 如果作業失敗,函式應該呼叫 SetLastError 來設定錯誤碼,然後傳回 FALSE。
言論
需要列印處理器才能匯出 ControlPrintProcessor 函式。 多任務緩衝處理程式會在應用程式呼叫 SetJob 函式時呼叫函式,如Microsoft Windows SDK 檔中所述。
根據針對 Command收到的值,函式應該暫停、繼續或取消目前的作業。 當列印處理器的 printDocumentOnPrintProcessor 函式執行時,可以異步呼叫 ControlPrintProcessor 函式。 因此,必須採用某種同步處理技術,例如設定內部定義的事件對象以暫停作業,並在作業恢復時重設事件物件。 ControlPrintProcessor 函式可以在設定或重設事件對象之後快速傳回,而 PrintDocumentOnPrintProcessor 可以等候事件處於適當的狀態。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | winsplp.h (包括 Winsplp.h) |
連結庫 | Nwprint.lib |