WdfRequestRetrieveActivityId, fonction (wdfrequest.h)

Article
02/07/2025

[S’applique uniquement à UMDF]

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

Syntaxe

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

Paramètres

[in] Request

Handle vers un objet de requête de framework.

[out] ActivityId

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

Valeur de retour

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

Retourner le code	Description
STATUS_NOT_FOUND	Aucun ID d’activité n’est associé à la requête.

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

Remarques

Les demandes 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 appelé WdfRequestSetActivityId après réception de la demande. Pour plus d’informations sur le suivi d’événements pour Windows (ETW), consultez de suivi d’événements.

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

L’infrastructure ne 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é.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8.1
plateforme cible	Universel
version minimale de UMDF	2.0
d’en-tête	wdfrequest.h (include Wdf.h)
bibliothèque	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Voir aussi

WdfRequestSetActivityId

Partager via