Fungsi EngEnumForms (winddi.h)

Artikel
03/04/2024

Fungsi EngEnumForms menghitung formulir yang didukung oleh printer yang ditentukan.

Sintaks

ENGAPI BOOL EngEnumForms(
  [in]            HANDLE  hPrinter,
  [in]            DWORD   Level,
  [out, optional] LPBYTE  pForm,
  [in]            DWORD   cbBuf,
  [out]           LPDWORD pcbNeeded,
  [out]           LPDWORD pcReturned
);

Parameter

[in] hPrinter

Tangani ke pencetak yang formulirnya harus dijumlahkan. Ini adalah handel PDEV yang diteruskan sebagai parameter hDriverdrvEnablePDEV.

[in] Level

Menentukan versi struktur yang ditujukkan oleh pForm. Nilai ini harus 1, yang menunjukkan bahwa formulir yang dijumlahkan akan dikembalikan dalam struktur FORM_1_INFO.

[out, optional] pForm

Penunjuk ke array byte di mana struktur FORM_INFO_1 yang dijumlahkan ditulis.

[in] cbBuf

Menentukan ukuran, dalam byte, dari lpbForms.

[out] pcbNeeded

Penunjuk ke DWORD yang menerima jumlah byte yang disalin ke dalam pForm jika salinan berhasil diselesaikan. Jika pForm terlalu kecil untuk berisi semua data formulir yang dijumlahkan, DWORD ini menentukan jumlah byte yang diperlukan.

[out] pcReturned

Penunjuk ke DWORD yang menerima jumlah struktur FORM_INFO_1 yang disalin ke dalam pForm.

Nilai kembali

EngEnumForms mengembalikan TRUE jika semua parameter valid dan data formulir yang dijumlahkan berhasil disalin ke dalam pForm. Jika tidak, ia mengembalikan FALSE dan pesan kesalahan dicatat. Untuk mendapatkan informasi kesalahan, hubungi EngGetLastError.

Keterangan

Pengandar pencetak dapat memanggil EngEnumForms agar GDI mendapatkan daftar formulir yang didukung oleh printer tertentu. Informasi yang dijumlahkan dikembalikan sebagai array struktur FORM_INFO_1 (dideklarasikan dalam dokumentasi Microsoft Windows SDK) yang ditunjukkan oleh pForm. Jika array yang ditunjukkan oleh pForm tidak cukup besar untuk menyimpan data enumerasi, ukuran array yang diperlukan malah dikembalikan dalam pcbNeeded.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys

Lihat juga

DrvEnablePDEV

EngGetLastError

Bagikan melalui