DRIVER_ADD_DEVICE fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas AddDevice bertanggung jawab untuk membuat objek perangkat fungsi (FDO) atau memfilter objek perangkat (filter DO) untuk perangkat yang dijumlahkan oleh manajer Plug and Play (PnP).

Sintaks

DRIVER_ADD_DEVICE DriverAddDevice;

NTSTATUS DriverAddDevice(
  [in] _DRIVER_OBJECT *DriverObject,
  [in] _DEVICE_OBJECT *PhysicalDeviceObject
)
{...}

Parameter

[in] DriverObject

Penunjuk yang disediakan penelepon ke struktur DRIVER_OBJECT . Ini adalah obyek pengandar pengandar.

[in] PhysicalDeviceObject

Penunjuk yang disediakan penelepon ke struktur DEVICE_OBJECT mewakili objek perangkat fisik (PDO) yang dibuat oleh driver tingkat bawah.

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

Semua driver mode kernel yang mendukung PnP harus menyediakan rutinitas AddDevice .

Rutinitas AddDevice driver harus diberi nama XxxAddDevice, di mana Xxx adalah awalan khusus driver. Rutinitas DriverEntry driver harus menyimpan alamat rutin AddDevice di DriverObject-DriverExtension-AddDevice>>.

Tanggung jawab utama rutin AddDevice memanggil IoCreateDevice untuk membuat objek perangkat, lalu memanggil IoAttachDeviceToDeviceStack untuk melampirkan objek perangkat ke tumpukan perangkat. Untuk informasi terperinci tentang menerapkan rutinitas AddDevice driver, lihat Menulis AddDevice Routine.

Rutinitas AddDevice berjalan dalam konteks utas sistem di IRQL = PASSIVE_LEVEL.

Contoh

Untuk menentukan rutinitas panggilan balik AddDevice , 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.

Misalnya, untuk menentukan rutinitas panggilan balik AddDevice yang diberi nama MyAddDevice<, gunakan jenis DRIVER_ADD_DEVICE seperti yang ditunjukkan dalam contoh kode ini:

DRIVER_ADD_DEVICE MyAddDevice;

Kemudian, terapkan rutinitas panggilan balik Anda sebagai berikut:

_Use_decl_annotations_
NTSTATUS
  MyAddDevice(
    struct _DRIVER_OBJECT  *DriverObject,
    struct _DEVICE_OBJECT  *PhysicalDeviceObject 
    )
  {
      // Function body
  }

Jenis fungsi DRIVER_ADD_DEVICE 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_ADD_DEVICE 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 Wdm.h, Ntddk.h, Ntifs.h)
IRQL Dipanggil di PASSIVE_LEVEL (lihat bagian Keterangan).