DRIVER_UNLOAD fungsi panggilan balik (wdm.h)
Rutinitas Bongkar melakukan operasi apa pun yang diperlukan sebelum sistem membongkar driver.
Sintaks
DRIVER_UNLOAD DriverUnload;
void DriverUnload(
[in] _DRIVER_OBJECT *DriverObject
)
{...}
Parameter
[in] DriverObject
Penunjuk yang disediakan penelepon ke struktur DRIVER_OBJECT . Ini adalah objek driver driver.
Nilai kembali
Tidak ada
Keterangan
Rutinitas Bongkar driver dijalankan dalam konteks utas sistem di IRQL = PASSIVE_LEVEL.
Rutinitas Bongkar diperlukan untuk driver WDM dan opsional untuk driver non-WDM. Rutinitas Bongkar muat driver, jika disediakan, harus diberi nama XxxUnload, di mana Xxx adalah awalan khusus driver. Rutinitas DriverEntry driver harus menyimpan alamat rutin Unload di DriverObject-DriverUnload>. (Jika tidak ada rutinitas yang disediakan, pointer ini harus NULL.)
Untuk informasi terperinci tentang menerapkan rutinitas Bongkar Muat driver, lihat Menulis Rutinitas Bongkar Muat.
Contoh
Untuk menentukan rutinitas Bongkar panggilan balik, Anda harus terlebih dahulu memberikan deklarasi fungsi yang mengidentifikasi jenis rutinitas panggilan balik yang Anda tentukan. Windows menyediakan sekumpulan tipe fungsi panggilan balik untuk pengandar. 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.
Misalnya, untuk menentukan rutinitas Bongkar panggilan balik yang diberi nama MyUnload
, gunakan jenis DRIVER_UNLOAD seperti yang ditunjukkan dalam contoh kode ini:
DRIVER_UNLOAD MyUnload;
Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:
_Use_decl_annotations_
VOID
MyUnload(
struct _DRIVER_OBJECT *DriverObject
)
{
// Function body
}
Jenis fungsi DRIVER_UNLOAD ditentukan 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_UNLOAD 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 Perilaku Fungsi Anotasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h) |
IRQL | Dipanggil pada PASSIVE_LEVEL. |
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