Struktur DRVENABLEDATA (winddi.h)

Artikel
03/13/2024

Struktur DRVENABLEDATA berisi penunjuk ke array struktur DRVFN dan nomor versi DDI grafis dari sistem operasi berbasis NT.

Sintaks

typedef struct tagDRVENABLEDATA {
  ULONG iDriverVersion;
  ULONG c;
  DRVFN *pdrvfn;
} DRVENABLEDATA, *PDRVENABLEDATA;

Anggota

iDriverVersion

Menentukan nomor versi DDI grafis dari sistem operasi berbasis NT yang ditargetkan driver. Anggota ini dapat diatur ke salah satu nilai berikut:

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

Lihat bagian Keterangan untuk informasi selengkapnya.

c

Menentukan jumlah struktur DRVFN dalam buffer yang diacu oleh anggota pdrvfn .

pdrvfn

Pointer ke buffer yang berisi array struktur DRVFN .

Keterangan

Untuk menjalankan versi sistem operasi berbasis NT ini, anggota iDriverVersion harus diatur sebagai berikut:

Versi Windows	Nilai iDriverVersion
Windows NT 4.0	iDriverVersion == DDI_DRIVER_VERSION_NT4
Windows NT 4.0 SP3	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_SP3
Windows 2000	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5
Windows XP	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01
Windows XP SP1	<DDI_DRIVER_VERSION_NT4 = iDriverVersion<= DDI_DRIVER_VERSION_NT5_01_SP1

Seperti yang ditunjukkan oleh tabel, driver dapat berjalan pada salah satu versi sistem operasi ini jika iDriverVersion diatur ke DDI_DRIVER_VERSION_NT4, tetapi driver hanya dapat berjalan pada Windows XP dan versi sistem operasi yang lebih baru jika iDriverVersion diatur ke DDI_DRIVER_VERSION_NT5_01.

Catatan Jika driver mengimplementasikan DDI grafis DrvXxx yang tidak didukung di semua versi Windows, driver tidak dapat menentukan entri DRVFN untuk DDI grafis tersebut saat berjalan pada versi Windows yang tidak mendukungnya. Jika driver menentukan entri DRVFN untuk DDI grafis seperti itu, Windows akan menolak driver. Sampel permedia2 menunjukkan cara menentukan struktur DRVFN yang berbeda untuk versi Windows yang berbeda.

Persyaratan

Persyaratan	Nilai
Header	winddi.h (termasuk Winddi.h)

Lihat juga

DRVFN

DrvEnableDriver

Bagikan melalui