Fungsi DrvStartDoc (winddi.h)

  • Artikel

Fungsi DrvStartDoc dipanggil oleh GDI ketika siap untuk mulai mengirim dokumen ke driver untuk penyajian.

Sintaks

BOOL DrvStartDoc(
  [in] SURFOBJ *pso,
  [in] LPWSTR  pwszDocName,
  [in] DWORD   dwJobId
);

Parameter

[in] pso

Penunjuk yang disediakan penelepon ke struktur SURFOBJ .

[in] pwszDocName

Penunjuk yang disediakan penelepon ke string Unicode yang dihentikan NULL yang menentukan nama dokumen yang akan dicetak.

[in] dwJobId

Nomor pekerjaan cetak yang disediakan penelepon. Nilai ini dikembalikan ke GDI dari penampung dalam panggilan ke StartDocPrinter.

Menampilkan nilai

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

Keterangan

DLL grafis printer harus menyediakan fungsi DrvStartDoc. Biasanya fungsi ini digunakan untuk mengirim urutan kontrol ke perangkat keras printer, sebelum dokumen dicetak, dengan memanggil fungsi EngWritePrinter GDI. Fungsi ini juga dapat melakukan operasi inisialisasi internal khusus dokumen untuk DLL grafis printer.

Fungsi DrvStartDoc dipanggil pada awal pekerjaan cetak, dan setiap kali aplikasi (seperti prosesor cetak) memanggil ResetDC (lihat DrvResetPDEV). Ketika panggilan ke DrvStartDoc berasal dari ResetDC, parameter pwszDocName diatur ke NULL dan parameter dwJobId diatur ke nol. Ketika panggilan berasal dari aplikasi, parameter ini masing-masing diatur, ke nama dokumen dan nomor pekerjaan cetak.

Karena tidak ada panggilan terpisah ke DLL grafis pencetak ketika pekerjaan cetak dimulai, fungsi DrvStartDoc juga harus mengirim urutan kontrol ke pencetak untuk menginisialisasi pekerjaan, jika diperlukan oleh pencetak. (Dengan kata lain, ada satu dokumen per pekerjaan.)

Persyaratan

   
Target Platform Desktop
Header winddi.h (termasuk Winddi.h)

Lihat juga

DrvEndDoc

DrvResetPDEV

EngWritePrinter