共用方式為


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

另請參閱

OpenPrintProcessor

PrintDocumentOnPrintProcessor