Fungsi DrvStartBanding (winddi.h)

Artikel
03/13/2024

Fungsi DrvStartBanding dipanggil oleh GDI ketika siap untuk mulai mengirim pita halaman fisik ke driver untuk penyajian.

Sintaks

BOOL DrvStartBanding(
  [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 pertama.

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 DrvStartBanding hanya jika grafik printer fungsi DrvEnableSurface DLL yang sebelumnya disebut EngMarkBandingSurface untuk menentukan permukaan banding.

Tujuan fungsi DrvStartBanding adalah untuk memungkinkan DLL grafis printer melakukan inisialisasi apa pun yang diperlukan sebelum operasi pita dimulai pada halaman fisik, dan untuk memberi GDI indeks asal band pertama.

Fungsi DrvStartBanding dipanggil sekali per halaman. Setiap kali GDI selesai menggambar band, GDI memanggil DrvNextBand sehingga driver dapat mengirim band ke printer.