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.