Partager via


Fonction EtwUnregister (wdm.h)

La fonction EtwUnregister annule l’inscription du fournisseur d’événements et doit être appelée avant la sortie du fournisseur.

Syntaxe

NTSTATUS EtwUnregister(
  [in] REGHANDLE RegHandle
);

Paramètres

[in] RegHandle

Pointeur vers le handle d’inscription du fournisseur, retourné par la fonction EtwRegister si l’inscription du fournisseur d’événements réussit.

Valeur de retour

La fonction EtwUnregister retourne un code d’état de STATUS_SUCCESS si le fournisseur d’événements n’a pas été inscrit avec ETW.

Remarques

Une fois le suivi terminé, un pilote doit appeler la fonction EtwUnregister pour annuler l’inscription du fournisseur. Pour chaque appel à EtwRegister il doit y avoir un appel correspondant à EtwUnregister. L’échec de l’inscription du fournisseur d’événements peut entraîner des erreurs lorsque le processus est déchargé, car les rappels associés au processus ne sont plus valides. Aucun appel de suivi ne doit être effectué qui se trouvent en dehors du code délimité par les fonctions EtwRegister et EtwUnregister. Pour des performances optimales, vous pouvez appeler la fonction EtwRegister dans votre routine DriverEntry et la fonction EtwUnregister dans votre routine DriverUnload.

Les appelants de EtwRegister doivent s’exécuter à IRQL = PASSIVE_LEVEL dans le contexte d’un thread système.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête wdm.h (include Wdm.h, Ntddk.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe; Ntdll.dll
IRQL PASSIVE_LEVEL
règles de conformité DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Voir aussi

EtwRegister