Fonction IoUnregisterPlugPlayNotification (wdm.h)

  • Article

Cette routine est obsolète dans Windows 7 et les versions ultérieures de Windows. Pour plus d’informations, consultez la section Remarques ci-dessous.

La routine IoUnregisterPlugPlayNotification supprime l’inscription d’une 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 retournée

IoUnregisterPlugPlayNotification retourne toujours STATUS_SUCCESS si NotificationEntry est valide.

Remarques

Dans Windows 7 et les versions ultérieures de Windows, cette fonction est obsolète et 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 après que la méthode IoUnregisterPlugPlayNotification a été retournée. Si nécessaire, un pilote doit implémenter son propre mécanisme pour ignorer toutes les notifications après l’appel d’IoUnregisterPlugPlayNotification .

IoUnregisterPlugPlayNotification supprime une inscription de notification PnP ; c’est-à-dire 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.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
En-tête wdm.h (inclure 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)

Voir aussi

IoRegisterPlugPlayNotification

IoUnregisterPlugPlayNotificationEx