struktur WDF_DRIVER_CONFIG (wdfdriver.h)

Artikel
08/08/2023

[Berlaku untuk KMDF dan UMDF]

Struktur WDF_DRIVER_CONFIG adalah parameter input untuk WdfDriverCreate.

Sintaks

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

EvtDriverDeviceAdd

Penunjuk ke fungsi panggilan balik EvtDriverDeviceAdd driver.

EvtDriverUnload

Penunjuk ke fungsi panggilan balik EvtDriverUnload driver.

DriverInitFlags

Bitwise ATAU dari satu atau beberapa nilai WDF_DRIVER_INIT_FLAGS-ketik yang mengidentifikasi bendera inisialisasi driver.

DriverPoolTag

(KMDF versi 1.5 dan yang lebih baru.) Tag kumpulan yang ditentukan driver yang akan ditetapkan kerangka kerja ke semua alokasi kumpulan driver. Debugger menampilkan tag ini. Untuk informasi selengkapnya tentang menentukan tag kumpulan, lihat bagian Keterangan berikut ini.

Keterangan

Driver Anda dapat secara opsional menentukan tag kumpulan yang akan ditetapkan kerangka kerja ke semua alokasi kumpulan driver. Driver biasanya menentukan string karakter hingga empat karakter, dibatasi oleh tanda kutip tunggal, dalam urutan terbalik (misalnya, 'dcba'). Nilai ASCII dari setiap karakter dalam tag harus antara 0 dan 127.

Jika DriverPoolTag adalah nol, kerangka kerja membuat tag kumpulan default dengan menggunakan empat karakter pertama dari nama layanan mode kernel driver Anda. Jika nama layanan dimulai dengan "WDF" (namanya tidak peka huruf besar/kecil dan tidak menyertakan tanda kutip), empat karakter berikutnya akan digunakan. Jika kurang dari empat karakter tersedia, "FxDr" digunakan.

Untuk menginisialisasi struktur WDF_DRIVER_CONFIG, driver harus memanggil WDF_DRIVER_CONFIG_INIT.