Fungsi DrvQueryPerBandInfo (winddi.h)

Fungsi DrvQueryPerBandInfo grafis printer DLL dipanggil oleh GDI sebelum mulai menggambar band untuk halaman fisik, sehingga driver dapat menyediakan GDI dengan informasi khusus pita.

Sintaks

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

Parameter

[in] pso

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

[in, out] pbi

Penunjuk yang disediakan penelepon ke struktur PERBANDINFO yang berisi informasi default, yang dapat ditimpa fungsi.

Mengembalikan nilai

Fungsi harus mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
Lebih besar dari nol	GDI akan menggunakan isi struktur PERBANDINFO.
Nol	GDI akan mengabaikan isi struktur PERBANDINFO.
DDI_ERROR	GDI tidak akan menggambar band.

Keterangan

Jika DLL grafis printer menggunakan permukaan yang dikelola GDI, dan jika mendukung pemalutan permukaan, dll dapat secara opsional menyediakan fungsi DrvQueryPerBandInfo . GDI memanggil fungsi sebelum merender setiap band.

DLL grafis printer menggunakan struktur PERBANDINFO fungsi untuk menunjukkan apakah pita sebelumnya harus digambar ulang, dan untuk menentukan bahwa pita harus diskalakan. Jika DLL grafis printer mendukung pita tetapi tidak menyediakan fungsi DrvQueryPerBandInfo , GDI tidak akan mengulangi atau menskalakan pita.

Fungsi DrvQueryPerBandInfo hanya dipanggil selama pemutaran file EMF.

Persyaratan

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

Lihat juga

DrvNextBand

DrvStartBanding