Fungsi DrvStartDoc (winddi.h)
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) |