Mendaftar untuk Pemberitahuan Perubahan Perangkat Target

Driver mendaftar untuk pemberitahuan peristiwa perubahan perangkat target PnP dengan memanggil IoRegisterPlugPlayNotification.

Informasi berikut berlaku untuk memanggil rutinitas ini untuk pemberitahuan perubahan perangkat target:

• Tentukan EventCategory dari EventCategoryTargetDeviceChange.

• EventCategoryData harus menunjuk ke objek file untuk perangkat tempat pemberitahuan diminta.

  Jika rutinitas panggilan balik driver memerlukan akses ke objek file, driver harus mengambil referensi pada objek file sebelum memanggil IoRegisterPlugPlayNotification.

  Jika rutinitas panggilan balik driver tidak memerlukan akses ke objek file, driver tidak perlu mereferensikan objek.

  Setelah objek file ditutup, driver terus menerima pemberitahuan untuk perangkat sampai driver menghapus pendaftaran notifikasinya. Desain ini memungkinkan driver untuk menerima pemberitahuan peristiwa GUID_TARGET_DEVICE_REMOVE_CANCELLED, misalnya.

• Tentukan Konteks yang ditentukan oleh driver yang akan diteruskan manajer PnP ke rutinitas panggilan balik.

  Driver mungkin menggunakan parameter Konteks untuk mempertahankan informasi tentang status objek file saat ini (misalnya, telah ditutup/dihapus).

  Driver mungkin juga menggunakan Konteks untuk menyimpan path yang digunakannya untuk awalnya membuka perangkat. Pengemudi dapat menggunakan jalur ini untuk membuka kembali perangkat setelah penghapusan yang dibatalkan. (Lihat Menangani Acara GUID_TARGET_DEVICE_REMOVE_CANCELLED untuk informasi lebih lanjut.)

Driver menghapus pendaftaran pemberitahuan dengan memanggil IoUnregisterPlugPlayNotification menggunakan NotificationEntry yang dikembalikan oleh IoRegisterPlugPlayNotification. Jika driver mengeluarkan referensi pada objek file ketika terdaftar untuk pemberitahuan dan referensi tersebut masih belum selesai, driver harus melepaskan referensi setelah menghapus pendaftaran.