Fungsi DrvSendPage (winddi.h)

Artikel
08/27/2023

Fungsi DrvSendPage grafis printer DLL dipanggil oleh GDI setelah selesai menggambar halaman fisik, sehingga driver dapat mengirim halaman ke printer.

Sintaks

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Parameter

[in] pso

Penunjuk yang disediakan penelepon ke struktur SURFOBJ yang menjelaskan permukaan gambar.

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

GDI memanggil DrvSendPage setiap kali selesai menggambar gambar halaman fisik di permukaan gambar. Fungsi ini bertanggung jawab untuk memanggil EngWritePrinter untuk mengirim gambar ke printer, dan untuk melakukan operasi akhir halaman, seperti mengeluarkan halaman.

DLL grafis printer yang menggunakan permukaan yang dikelola GDI biasanya diimplementasikan sehingga untuk halaman yang dipita, gambar untuk setiap pita dikirim ke printer oleh fungsi DrvNextBand driver.

Selain itu, jika DLL grafis printer menggunakan permukaan yang dikelola perangkat, fungsi DrvSendPage biasanya hanya perlu melakukan operasi akhir halaman, karena gambar dikirim ke printer saat digambar.

Jika ada potensi fungsi ini membutuhkan waktu lama untuk dijalankan, fungsi ini harus memanggil EngCheckAbort setiap lima detik. Jika EngCheckAbort mengembalikan TRUE, DrvSendPage harus mengakhiri operasinya dan mengembalikan FALSE.