WdfRequestRetrieveActivityId, fonction (wdfrequest.h)

[S’applique à UMDF uniquement]

La méthode WdfRequestRetrieveActivityId récupère l’identificateur d’activité actuel associé à une demande d’E/S.

Syntaxe

NTSTATUS WdfRequestRetrieveActivityId(
  [in]  WDFREQUEST Request,
  [out] LPGUID     ActivityId
);

Paramètres

[in] Request

Handle pour un objet de requête d’infrastructure.

[out] ActivityId

Pointeur vers un emplacement pour stocker le GUID récupéré.

Valeur retournée

Si l’opération réussit, WdfRequestRetrieveActivityId retourne STATUS_SUCCESS. Les valeurs de retour supplémentaires sont les suivantes :

La méthode peut retourner d’autres valeurs NTSTATUS.

Remarques

Les requêtes reflétées à partir du mode noyau ont un identificateur d’activité disponible uniquement si le fournisseur trace du noyau est activé ou si le pilote UMDF a appelé WdfRequestSetActivityId après avoir reçu la demande. Pour plus d’informations sur le suivi d’événements pour Windows (ETW), consultez Suivi d’événements.

Les requêtes lancées par le pilote UMDF ont un identificateur d’activité disponible uniquement si le pilote UMDF s’appelait précédemment WdfRequestSetActivityId.

L’infrastructure n’efface pas l’identificateur d’activité d’une requête lorsque le pilote appelle WdfRequestReuse.

Pour plus d’informations sur les identificateurs d’activité, consultez Utilisation des identificateurs d’activité.

Configuration requise

Voir aussi

WdfRequestSetActivityId