WdfRequestRetrieveActivityId, fonction (wdfrequest.h)

Article
02/27/2024

[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 :

Code de retour	Description
STATUS_NOT_FOUND	Aucun ID d’activité n’est associé à la demande.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Plateforme cible	Universal
Version UMDF minimale	2.0
En-tête	wdfrequest.h (inclure Wdf.h)
Bibliothèque	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Voir aussi

WdfRequestSetActivityId

Partager via