Fungsi PrintDocumentOnPrintProcessor (winsplp.h)

Fungsi prosesor PrintDocumentOnPrintProcessor cetak mengonversi pekerjaan cetak dari format yang ditampung menjadi data mentah yang dapat dikirim ke monitor cetak.

Sintaks

BOOL PrintDocumentOnPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] LPWSTR pDocumentName
);

Parameter

[in] hPrintProcessor

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

[in] pDocumentName

Penunjuk yang disediakan penelepon ke nama dokumen.

Nilai kembali

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 PrintDocumentOnPrintProcessor fungsi. Penampung memanggil fungsi setelah memanggil OpenPrintProcessor. Tujuan fungsi ini adalah untuk membaca konten file yang dinamai oleh pDocumentName, mengonversi (jika perlu) data file ke aliran data yang dapat dibaca oleh perangkat keras printer, dan untuk mengirim aliran data kembali ke penampung. Penampung kemudian dapat mengirim aliran data ke monitor cetak yang sesuai.

Jika format input adalah EMF sistem operasi berbasis NT, PrintDocumentOnPrintProcessor fungsi dapat memanggil fungsi GDI untuk prosesor cetak. Untuk informasi selengkapnya, lihat Memproses Pekerjaan Cetak.

Aliran data yang dikonversi harus dikirim kembali ke penampung dengan memanggil WritePrinter, yang dijelaskan dalam dokumentasi Microsoft Windows SDK. Untuk informasi selengkapnya, lihat Memproses Pekerjaan Cetak.

Fungsi PrintDocumentOnPrintProcessor harus ditulis untuk menangani permintaan untuk menjeda, melanjutkan, atau membatalkan tugas cetak. Untuk informasi selengkapnya, lihat ControlPrintProcessor.

Persyaratan

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

Lihat juga

ControlPrintProcessor

OpenPrintProcessor