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) |