Funzione IoUnregisterPlugPlayNotification (wdm.h)

Questa routine è obsoleta in Windows 7 e versioni successive di Windows. Per altre informazioni, vedere la sezione osservazioni di seguito.

La routine IoUnregisterPlugPlayNotification rimuove la registrazione della routine di callback di un driver per un evento PnP.

Sintassi

NTSTATUS IoUnregisterPlugPlayNotification(
  [in] PVOID NotificationEntry
);

Parametri

[in] NotificationEntry

Puntatore a un valore opaco che rappresenta la registrazione da rimuovere. Il valore è stato restituito da una chiamata precedente a IoRegisterPlugPlayNotification.

Valore restituito

IoUnregisterPlugPlayNotification restituisce sempre STATUS_SUCCESS se NotificationEntry è valido.

Osservazioni

In Windows 7 e versioni successive di Windows questa funzione è obsoleta e viene fornita solo per supportare i driver esistenti. Usare invece la routine IoUnregisterPlugPlayNotificationEx.

Il sistema non esegue la sincronizzazione tra l'esecuzione della routine di notifica e IoUnregisterPlugPlayNotification. Di conseguenza, la routine può essere chiamata dopo la restituzione del metodo IoUnregisterPlugPlayNotification. Se necessario, un driver deve implementare il proprio meccanismo per ignorare eventuali notifiche dopo che è stata chiamata IoUnregisterPlugPlayNotification.

IoUnregisterPlugPlayNotification rimuove una registrazione di notifica PnP; ovvero la registrazione di una routine di callback del driver per una categoria di eventi PnP.

I driver devono prima annullare la registrazione di una notifica, quindi liberare qualsiasi buffer di contesto correlato.

Un driver non può essere scaricato fino a quando non rimuove tutte le registrazioni di notifica PnP perché è presente un riferimento sull'oggetto driver per ogni registrazione attiva.

Fabbisogno

Vedere anche

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx