IoUnregisterPlugPlayNotification, fonction (wdm.h)
Cette routine est obsolète dans Windows 7 et versions ultérieures de Windows. Pour plus d’informations, consultez la section Remarques ci-dessous.
La routine IoUnregisterPlugPlayNotification supprime l’inscription de la routine de rappel d’un pilote pour un événement PnP.
Syntaxe
NTSTATUS IoUnregisterPlugPlayNotification(
[in] PVOID NotificationEntry
);
Paramètres
[in] NotificationEntry
Pointeur vers une valeur opaque représentant l’inscription à supprimer. La valeur a été retournée par un appel précédent à IoRegisterPlugPlayNotification.
Valeur de retour
IoUnregisterPlugPlayNotification retourne toujours STATUS_SUCCESS si notificationEntry est valide.
Remarques
Dans Windows 7 et versions ultérieures de Windows, cette fonction est obsolète et est fournie uniquement pour prendre en charge les pilotes existants. Utilisez plutôt la routine IoUnregisterPlugPlayNotificationEx.
Le système ne se synchronise pas entre l’exécution de la routine de notification et IoUnregisterPlugPlayNotification. Par conséquent, la routine peut être appelée une fois la méthode IoUnregisterPlugPlayNotification retournée. Si nécessaire, un pilote doit implémenter son propre mécanisme pour ignorer les notifications après IoUnregisterPlugPlayNotification a été appelée.
IoUnregisterPlugPlayNotification supprime une inscription de notification PnP ; autrement dit, l’inscription d’une routine de rappel de pilote pour une catégorie d’événements PnP.
Les pilotes doivent d’abord annuler l’inscription d’une notification, puis libérer toute mémoire tampon de contexte associée.
Un pilote ne peut pas être déchargé tant qu’il n’a pas supprimé toutes ses inscriptions de notification PnP, car il existe une référence sur son objet de pilote pour chaque inscription active.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |