Fungsi DrvNextBand (winddi.h)

Artikel
03/04/2024

Fungsi DrvNextBand dipanggil oleh GDI ketika telah selesai menggambar pita untuk halaman fisik, sehingga driver dapat mengirim pita berikutnya ke printer.

Sintaks

BOOL DrvNextBand(
  [in] SURFOBJ *pso,
  [in] POINTL  *pptl
);

Parameter

[in] pso

Penunjuk yang disediakan penelepon ke struktur SURFOBJ , yang mengidentifikasi permukaan pita.

[in] pptl

Penunjuk yang disediakan penelepon ke struktur POINTL untuk menerima asal yang disediakan fungsi dari pita berikutnya.

Nilai kembali

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

Keterangan

Jika DLL grafis printer menggunakan permukaan yang dikelola GDI, dan jika mendukung pemalutan permukaan, DLL harus menyediakan fungsi DrvNextBand . GDI memanggil DrvNextBand setiap kali selesai menggambar bagian gambar halaman yang dapat dimuat di permukaan band. Permukaan yang digunakan oleh GDI untuk menggambar adalah salah satu yang sebelumnya ditentukan driver dengan memanggil EngMarkBandingSurface. Fungsi harus mengirim gambar ke printer dengan memanggil EngWritePrinter, dan harus mengembalikan indeks asal pita berikutnya dalam struktur POINTL yang diarahkan oleh pptl.

Setelah semua pita halaman fisik digambar, fungsi harus mengatur kedua anggota struktur POINTL yang ditujukkan oleh pptl ke -1.