DRIVER_UNLOAD fungsi panggilan balik (wdm.h)

Artikel
07/02/2025

Rutinitas Unload melakukan operasi apa pun yang diperlukan sebelum sistem membongkar driver.

Sintaksis

C++

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.

Mengembalikan nilai

Tidak

Komentar

Rutinitas Unload driver dijalankan dalam konteks utas sistem di IRQL = PASSIVE_LEVEL.

Rutinitas Unload diperlukan untuk driver WDM dan opsional untuk driver non-WDM. Rutinitas Unload 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 Unload driver, lihat MenulisRutin Bongkar .

Contoh

Untuk menentukan rutinitas panggilan balik Unload, 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 panggilan balik Unload yang diberi nama MyUnload, gunakan jenis DRIVER_UNLOAD seperti yang ditunjukkan dalam contoh kode ini:

C++

DRIVER_UNLOAD MyUnload;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

C++

_Use_decl_annotations_
VOID 
  MyUnload(
    struct _DRIVER_OBJECT  *DriverObject
    )
  {
      // Function body
  }

Jenis fungsi DRIVER_UNLOAD ditentukan dalam file header Wdm.h. Untuk mengidentifikasi kesalahan dengan lebih akurat saat Anda menjalankan alat analisis kode, pastikan untuk menambahkan anotasi _Use_decl_annotations_ 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 Anotasi Perilaku Fungsi.

Persyaratan

Syarat	Nilai
Platform Target	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Dipanggil di PASSIVE_LEVEL.

Bagikan melalui