Fungsi IoUnregisterPlugPlayNotification (wdm.h)

  • Artikel

Rutinitas ini usang di Windows 7 dan versi Windows yang lebih baru. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

Rutinitas IoUnregisterPlugPlayNotification menghapus pendaftaran rutinitas panggilan balik driver untuk peristiwa PnP.

Sintaks

NTSTATUS IoUnregisterPlugPlayNotification(
  [in] PVOID NotificationEntry
);

Parameter

[in] NotificationEntry

Penunjuk ke nilai buram yang mewakili pendaftaran yang akan dihapus. Nilai dikembalikan oleh panggilan sebelumnya ke IoRegisterPlugPlayNotification.

Mengembalikan nilai

IoUnregisterPlugPlayNotification selalu mengembalikan STATUS_SUCCESS jika NotificationEntry valid.

Keterangan

Di Windows 7 dan versi Windows yang lebih baru, fungsi ini kedaluarsa dan disediakan hanya untuk mendukung driver yang ada. Gunakan rutinitas IoUnregisterPlugPlayNotificationEx sebagai gantinya.

Sistem tidak menyinkronkan antara eksekusi rutinitas pemberitahuan dan IoUnregisterPlugPlayNotification. Oleh karena itu, rutinitas dapat dipanggil setelah metode IoUnregisterPlugPlayNotification telah kembali. Jika perlu, driver harus menerapkan mekanismenya sendiri untuk mengabaikan pemberitahuan apa pun setelah IoUnregisterPlugPlayNotification dipanggil.

IoUnregisterPlugPlayNotification menghapus satu pendaftaran pemberitahuan PnP; yaitu, pendaftaran satu rutinitas panggilan balik driver untuk satu kategori peristiwa PnP.

Driver harus membatalkan pendaftaran pemberitahuan terlebih dahulu, lalu membebaskan buffer konteks terkait.

Driver tidak dapat dibongkar sampai menghapus semua pendaftaran pemberitahuan PnP-nya karena ada referensi pada objek driver untuk setiap pendaftaran aktif.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx