Fonction EtwActivityIdControl (wdm.h)
La fonction EtwActivityIdControl crée, interroge et définit l’identificateur d’activité actuel.
Syntaxe
NTSTATUS EtwActivityIdControl(
[in] ULONG ControlCode,
[in, out] LPGUID ActivityId
);
Paramètres
[in] ControlCode
Le paramètre ControlCode peut être l’une des valeurs définies suivantes.
| Valeur | Signification |
|---|---|
| EVENT_ACTIVITY_CTRL_GET_ID | Retourne l’identificateur d’activité du thread actuel dans le paramètre ActivityId. |
| EVENT_ACTIVITY_CTRL_SET_ID | Définit l’identificateur d’activité du thread actuel sur la valeur spécifiée dans ActivityId. Notez que l’Id d’activité que vous passez à cette fonction n’a pas nécessairement besoin d’être créé par EVENT_ACTIVITY_CTRL_CREATE_ID ou par EVENT_ACTIVITY_CTRL_CREATE_SET_ID code de contrôle. Vous pouvez utiliser n’importe quelle valeur qui correspond à un GUID, y compris toute valeur locale disponible qui servirait votre besoin pour un type d’identificateur d’activité. |
| EVENT_ACTIVITY_CTRL_CREATE_ID | Crée un identificateur et définit le paramètre ActivityId sur la valeur du nouvel identificateur. |
| EVENT_ACTIVITY_CTRL_GET_SET_ID | Définit l’identificateur d’activité du thread actuel sur la valeur spécifiée dans ActivityId, puis retourne ActivityId avec la valeur de l’identificateur d’activité du thread avant l’appel de fonction. |
| EVENT_ACTIVITY_CTRL_CREATE_SET_ID | Copie l’identificateur d’activité du thread actuel. Crée un identificateur et définit l’identificateur d’activité du thread actuel sur la nouvelle valeur. Retourne ActivityId avec la valeur de l’identificateur d’activité du thread avant l’appel de fonction. |
[in, out] ActivityId
Identificateur qui indique l’activité associée à l’événement. Le paramètre ActivityId permet de regrouper les événements associés et est utilisé dans le suivi de bout en bout.
Valeur de retour
EtwActivityIdControl retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée.
Remarques
Les identificateurs d’activité fournissent une méthode de liaison d’événements distincts dans un thread commun de calcul. Une activité est un élément de travail effectué par une application et ou un pilote. Le concept d’activité est un composant principal du suivi de bout en bout.
Les appelants de EtwActivityIdControl doivent s’exécuter au < DISPATCH_LEVEL IRQL, sauf si le ControlCode est EVENT_ACTIVITY_CTRL_CREATE_ID, auquel cas la fonction peut être appelée à n’importe quel runtime IRQL.
Utilisez la fonction EtwActivityIdControlKernel pour interroger ou définir des threads de noyau d’identificateurs d’activité.
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 | Voir la section Commentaires |