DRIVER_INITIALIZE fungsi panggilan balik (wdm.h)
DriverEntry adalah rutinitas pertama yang dipanggil setelah driver dimuat, dan bertanggung jawab untuk menginisialisasi driver.
Sintaks
DRIVER_INITIALIZE DriverInitialize;
NTSTATUS DriverInitialize(
[in] _DRIVER_OBJECT *DriverObject,
[in] PUNICODE_STRING RegistryPath
)
{...}
Parameter
[in] DriverObject
Penunjuk ke struktur DRIVER_OBJECT . Ini adalah obyek pengandar pengandar.
[in] RegistryPath
Penunjuk ke string Unicode terhitung yang menentukan jalur ke kunci registri driver.
Nilai kembali
Jika rutinitas berhasil, rutinitas harus mengembalikan STATUS_SUCCESS. Jika tidak, itu harus mengembalikan salah satu nilai status kesalahan yang ditentukan dalam Ntstatus.h.
Keterangan
Parameter DriverObject memasok rutinitas DriverEntry dengan pointer ke objek driver driver, yang dialokasikan oleh manajer I/O. Rutinitas DriverEntry harus mengisi objek driver dengan titik masuk untuk rutinitas standar driver.
Penunjuk DriverObject memberikan akses driver ke DriverObject-HardwareDatabase>, yang menunjuk ke string Unicode terhitung yang menentukan jalur ke pohon \Registry\Machine\Hardware registri.
String jalur registri yang ditunjukkan oleh RegistryPath adalah dari bentuk \Registry\Machine\System\CurrentControlSet\Services\DriverName. Driver dapat menggunakan jalur ini untuk menyimpan informasi khusus driver; lihat Kunci Registri untuk Driver. Rutinitas DriverEntry harus menyimpan salinan string Unicode, bukan pointer, karena manajer I/O membebaskan buffer RegistryPath setelah DriverEntry kembali.
Untuk informasi selengkapnya tentang menerapkan rutinitas DriverEntry , lihat Menulis Rutinitas DriverEntry.
Meskipun dimungkinkan untuk memberi nama rutinitas ini sesuatu selain DriverEntry, melakukannya tidak disarankan. Alat build yang disediakan DDK secara otomatis menginformasikan linker bahwa titik masuk driver disebut DriverEntry, jadi memberikan nama lain yang rutin mengharuskan Anda untuk memodifikasi alat build. Untuk informasi selengkapnya tentang alat build, lihat Membuat Driver.
Contoh
Untuk menentukan rutinitas panggilan balik DriverEntry , Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk driver. Mendeklarasikan fungsi menggunakan jenis fungsi panggilan balik membantu Analisis Kode untuk Driver, Pemverifikasi Driver Statis (SDV), dan alat verifikasi lainnya menemukan kesalahan, dan itu adalah persyaratan untuk menulis driver untuk sistem operasi Windows.
Untuk menentukan rutinitas panggilan balik DriverEntry , gunakan jenis DRIVER_INITIALIZE seperti yang ditunjukkan dalam contoh kode ini:
DRIVER_INITIALIZE DriverEntry;
Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:
_Use_decl_annotations_
NTSTATUS
DriverEntry(
struct _DRIVER_OBJECT *DriverObject,
PUNICODE_STRING RegistryPath
)
{
// Function body
}
Jenis fungsi DRIVER_INITIALIZE didefinisikan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan secara lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan _Use_decl_annotations_
anotasi ke definisi fungsi Anda. Anotasi _Use_decl_annotations_
memastikan bahwa anotasi yang diterapkan ke jenis fungsi DRIVER_INITIALIZE dalam file header digunakan. Untuk informasi selengkapnya tentang persyaratan untuk deklarasi fungsi, lihat Mendeklarasikan Fungsi dengan Menggunakan Jenis Peran Fungsi untuk Driver WDM. Untuk informasi tentang _Use_decl_annotations_
, lihat Menganotasi Perilaku Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | wdm.h (termasuk Mcd.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
IRQL | Dipanggil di PASSIVE_LEVEL. |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk