Fungsi ControlPrintProcessor (winsplp.h)

  • Artikel

Fungsi ControlPrintProcessor prosesor cetak memungkinkan penampung mengontrol pekerjaan cetak.

Sintaks

BOOL ControlPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] DWORD  Command
);

Parameter

[in] hPrintProcessor

Handel prosesor cetak yang disediakan penelepon. Ini adalah handel yang dikembalikan oleh panggilan sebelumnya ke OpenPrintProcessor.

[in] Command

Perintah yang disediakan penelepon menunjukkan jenis operasi yang akan dilakukan. Perintah berikut ini valid:

Perintah Definisi
JOB_CONTROL_CANCEL Fungsi harus membatalkan pekerjaan cetak saat ini.
JOB_CONTROL_PAUSE Fungsi harus menjeda pekerjaan cetak saat ini.
JOB_CONTROL_RESUME Fungsi harus melanjutkan tugas cetak saat ini.

Mengembalikan nilai

Jika operasi berhasil, fungsi harus mengembalikan TRUE. Jika operasi gagal, fungsi harus memanggil SetLastError untuk mengatur kode kesalahan, lalu mengembalikan FALSE.

Keterangan

Prosesor cetak diperlukan untuk mengekspor fungsi ControlPrintProcessor . Penampung memanggil fungsi saat aplikasi memanggil fungsi SetJob, yang dijelaskan dalam dokumentasi Microsoft Windows SDK.

Berdasarkan nilai yang diterima untuk Perintah, fungsi harus menjeda, melanjutkan, atau membatalkan pekerjaan saat ini. Fungsi ControlPrintProcessor dapat dipanggil secara asinkron saat fungsi PrintDocumentOnPrintProcessor prosesor cetak dijalankan. Dengan demikian, beberapa jenis teknik sinkronisasi harus digunakan, seperti mengatur objek peristiwa yang ditentukan secara internal untuk menjeda pekerjaan dan mengatur ulang objek peristiwa saat pekerjaan dilanjutkan. Fungsi ControlPrintProcessor dapat dengan cepat kembali setelah mengatur atau mengatur ulang objek peristiwa, dan PrintDocumentOnPrintProcessor dapat menunggu peristiwa berada dalam status yang tepat.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header winsplp.h (termasuk Winsplp.h)
Pustaka Nwprint.lib

Lihat juga

OpenPrintProcessor

PrintDocumentOnPrintProcessor