Fungsi DrvEnableDriver (winddi.h)
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 |
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | winddi.h (termasuk Winddi.h) |