Fungsi EngGetPrinterDriver (winddi.h)

Fungsi EngGetPrinterDriver mengambil data driver untuk printer yang ditentukan.

Sintaks

ENGAPI BOOL EngGetPrinterDriver(
  [in]            HANDLE hPrinter,
  [in, optional]  LPWSTR pEnvironment,
  [in]            DWORD  dwLevel,
  [out, optional] BYTE   *lpbDrvInfo,
  [in]            DWORD  cbBuf,
  [out]           DWORD  *pcbNeeded
);

Parameter

[in] hPrinter

Tangani ke pencetak tempat data pengandar harus diambil.

[in, optional] pEnvironment

Penunjuk ke string yang dihentikan null yang menentukan lingkungan. Misalnya, "Windows NT x86" menentukan sistem operasi berbasis NT yang berjalan pada prosesor Intel. Jika pEnvironmentADALAH NULL, lingkungan driver panggilan dan komputer klien saat ini digunakan.

[in] dwLevel

Menentukan versi struktur tempat lpbDrvInfo menunjuk. Parameter ini harus menjadi salah satu nilai berikut:

Nilai	Makna
1	GDI menulis struktur DRIVER_INFO_1 dalam buffer tempat lpbDrvInfo menunjuk.
2	GDI menulis struktur DRIVER_INFO_2 dalam buffer tempat lpbDrvInfo menunjuk.
3	GDI menulis struktur DRIVER_INFO_3 dalam buffer tempat lpbDrvInfo menunjuk.

[out, optional] lpbDrvInfo

Arahkan ke buffer tempat GDI menempatkan struktur DRIVER_INFO_X yang diminta.

[in] cbBuf

Menentukan ukuran, dalam byte, dari buffer tempat lpbDrvInfo menunjuk.

[out] pcbNeeded

Pointer ke lokasi memori di mana GDI menempatkan jumlah byte yang disalin ke dalam buffer yang ditunjukkan lpbDrvInfo setelah berhasil, atau jumlah byte yang diperlukan jika cbBuf terlalu kecil.

Nilai kembali

EngGetPrinterDriver mengembalikan TRUE setelah berhasil; jika tidak, ia melaporkan kesalahan dan mengembalikan FALSE.

Keterangan

DLL pengandar pencetak dapat bekerja dengan beberapa file data untuk mendukung model printer yang berbeda. Driver printer memanggil EngGetPrinterDriver untuk menentukan file data mana yang akan digunakan. Misalnya, perender Unidrv memanggil fungsi ini untuk menentukan nama file GPD , dan driver postscript memanggil fungsi ini untuk menentukan nama file PPD . Struktur DRIVER_INFO_2 dan DRIVER_INFO_3 berisi jalur lengkap dan nama file yang menentukan lokasi file data. Pengandar pencetak kemudian dapat menggunakan jalur dan nama file yang dikembalikan untuk memuat file data dengan memanggil EngLoadModule dengan jalur dan nama file sebagai argumen tunggal.

Struktur DRIVER_INFO_X dijelaskan dalam dokumentasi Microsoft Windows SDK.

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

EngLoadModule