Registrazione per la notifica di modifica dell'interfaccia del dispositivo
Un driver registra per la notifica degli eventi di arrivo e rimozione dell'interfaccia del dispositivo chiamando IoRegisterPlugPlayNotification.
Le informazioni seguenti si applicano alla chiamata di questa routine per la notifica delle modifiche dell'interfaccia del dispositivo:
Specificare un oggetto EventCategory di EventCategoryDeviceInterfaceChange.
EventCategoryData deve puntare al GUID per una classe di interfaccia del dispositivo.
Il GUID per una classe di interfaccia è in genere definito in un file di intestazione con le strutture, le costanti e così via, per l'interfaccia.
Specificare un oggetto EventCategoryFlags di PNPNOTIFY_DEVICE_INTERFACE_INCLUDE_EXISTING_INTERFACES.
Questo flag indirizza il gestore PnP a registrare callbackRoutine per gli arrivi e le partenze dell'interfaccia dispositivo futura della classe specificata e per chiamare immediatamente callbackRoutine per tutte le interfacce del dispositivo pertinenti già attive.
Un driver può chiamare IoGetDeviceInterfaces per ottenere un elenco di interfacce esistenti di una classe specifica e quindi registrare la routine di callback senza questo flag, ma l'uso del flag è più semplice ed evita un potenziale problema di intervallo.
Specificare un contesto definito dal driver, se appropriato, che il gestore PnP passerà alla routine di callback.
Un driver che apre un handle a un dispositivo in risposta a una notifica di arrivo dell'interfaccia dispositivo deve registrare gli eventi EventCategoryTargetDeviceChange nel dispositivo. Vedere Uso della notifica di modifica del dispositivo di destinazione PnP.
Un driver annulla la registrazione della notifica chiamando IoUnregisterPlugPlayNotification con notificationEntry restituito da IoRegisterPlugPlayNotification.