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 actif 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 ne doit pas nécessairement être créé par EVENT_ACTIVITY_CTRL_CREATE_ID ou EVENT_ACTIVITY_CTRL_CREATE_SET_ID code de contrôle. Vous pouvez utiliser n’importe quelle valeur qui s’adapte à un GUID, y compris toute valeur locale disponible qui répondrait à vos besoins 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 actif 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 actif. 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 des événements connexes et est utilisé dans le suivi de bout en bout.
Valeur retournée
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 de calcul commun. Une activité est un élément de travail effectué par une application et ou un pilote. Le concept d’activité est un composant essentiel du suivi de bout en bout.
Les appelants d’EtwActivityIdControl doivent être en cours d’exécution 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 IRQL.
Utilisez la fonction EtwActivityIdControlKernel pour interroger ou définir des threads de noyau d’identificateurs d’activité.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe ; Ntdll.dll |
| IRQL | Voir la section Commentaires |