Mendaftar untuk Pemberitahuan Perubahan Antarmuka Perangkat

Driver mendaftar untuk pemberitahuan peristiwa kedatangan dan penghapusan antarmuka perangkat dengan memanggil IoRegisterPlugPlayNotification.

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

• Tentukan EventCategory dari EventCategoryDeviceInterfaceChange.

• EventCategoryData harus menunjuk ke GUID untuk kelas antarmuka perangkat.

  GUID untuk kelas antarmuka biasanya didefinisikan dalam file header dengan struktur, konstanta, dan sebagainya, untuk antarmuka.

• Tentukan EventCategoryFlags dari PNPNOTIFY_DEVICE_INTERFACE_INCLUDE_EXISTING_INTERFACES.

  Bendera ini mengarahkan manajer PnP untuk mendaftarkan CallbackRoutine agar siap untuk kedatangan dan keberangkatan antarmuka perangkat dari kelas yang telah ditentukan di masa mendatang, serta untuk segera memanggil CallbackRoutine untuk antarmuka perangkat yang relevan yang sudah aktif.

  Driver dapat memanggil IoGetDeviceInterfaces untuk mendapatkan daftar antarmuka yang ada dari kelas tertentu dan kemudian mendaftarkan rutinitas panggilan baliknya tanpa bendera ini, tetapi menggunakan bendera lebih mudah dan menghindari potensi masalah waktu.

• Tentukan konteks yang ditentukan driver yang akan diteruskan oleh manajer PnP ke rutinitas panggilan balik, jika sesuai.

Driver yang membuka handle ke perangkat sebagai tanggapan atas pemberitahuan kedatangan antarmuka perangkat harus mendaftar untuk event EventCategoryTargetDeviceChange pada perangkat. (Lihat Menggunakan Pemberitahuan Perubahan Perangkat Target PnP.)

Driver membatalkan pendaftaran pemberitahuan dengan memanggil IoUnregisterPlugPlayNotification dengan NotificationEntry yang dikembalikan oleh IoRegisterPlugPlayNotification.