Fungsi DrvEnableDriver (winddi.h)

Artikel
03/04/2024

Fungsi DrvEnableDriver adalah titik masuk driver awal yang diekspor oleh DLL driver. Ini mengisi struktur DRVENABLEDATA dengan nomor versi DDI grafis driver dan alamat panggilan dari semua fungsi DDI grafis yang didukung oleh driver.

Sintaks

BOOL DrvEnableDriver(
       ULONG         iEngineVersion,
       ULONG         cj,
  [in] DRVENABLEDATA *pded
);

Parameter

iEngineVersion

Mengidentifikasi versi GDI yang saat ini berjalan.

cj

Adalah ukuran dalam byte struktur yang ditujukkan oleh pded. Jika struktur lebih besar dari yang diharapkan, anggota tambahan harus dibiarkan tidak dimodifikasi.

[in] pded

Pointer ke struktur DRVENABLEDATA . GDI menginisialisasi byte cj sebelum panggilan. Driver mengisi datanya sendiri.

Nilai kembali

Nilai yang dikembalikan adalah TRUE jika driver yang ditentukan diaktifkan. Jika tidak, itu FALSE, dan kode kesalahan dicatat.

Keterangan

DrvEnableDriver harus diimplementasikan di semua driver grafis. Jika Anda menggunakan alat build Windows Driver Kit (WDK) dan telah mengatur TARGETTYPE ke GDI_DRIVER (lihat Membangun DLL Grafis Printer), fungsi ini harus bernama DrvEnableDriver. Ini adalah satu-satunya fungsi driver tampilan yang harus diakses berdasarkan nama. Semua fungsi driver tampilan lainnya diakses melalui penunjuk fungsi; oleh karena itu, nama mereka disajikan dalam dokumentasi ini sebagai nama semu.

Inisialisasi satu kali, seperti mengalokasikan semaphores, juga dapat dilakukan oleh fungsi ini. Driver harus menunggu sampai DrvEnablePDEV dipanggil sebelum mengaktifkan perangkat keras, seperti layar.

Saat melakukan pemeriksaan versi menggunakan nilai yang disediakan di iEngineVersion, driver harus menggunakan konstanta DDI_DRIVER_VERSION_Xxx yang sesuai (ditentukan dalam winddi.h) yang ditunjukkan dalam tabel berikut. Driver hampir tidak boleh memeriksa hanya untuk kesetaraan karena versi baru dan rilis paket layanan untuk sistem operasi akan dirilis di masa depan. Untuk informasi selengkapnya, lihat DRVENABLEDATA.

Nilai	Versi Sistem Operasi
DDI_DRIVER_VERSION_NT4	Windows NT 4.0
DDI_DRIVER_VERSION_SP3	Windows NT 4.0 Paket Layanan 3
DDI_DRIVER_VERSION_NT5	Windows 2000
DDI_DRIVER_VERSION_NT5_01	Windows XP
DDI_DRIVER_VERSION_NT5_01_SP1	Windows XP Service Pack 1