Méthode IWDFIoRequest3 ::SetActivityId (wudfddi.h)

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode SetActivityId associe un identificateur d’activité à une demande d’E/S.

Syntaxe

void SetActivityId(
  [in] LPGUID ActivityId
);

Paramètres

[in] ActivityId

Pointeur vers le GUID d’identificateur d’activité à stocker dans la demande d’E/S.

Valeur de retour

None

Remarques

L’appel de SetActivityId ne définit pas d’association avec un identificateur d’activité précédemment présent. Lorsque le pilote appelle SetActivityId, tout identificateur d’activité existant est remplacé.

Pour définir une association, récupérez l’identificateur existant en appelant RetrieveActivityId , puis associez l’identificateur existant au nouveau en appelant EventWriteTransfer.

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

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

L’équivalent UMDF 2 de cette méthode est WdfRequestSetActivityId.

Exemples

Pour obtenir un exemple de code qui utilise SetActivityId, consultez RetrieveActivityId.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.11
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFIoRequest3

IWDFIoRequest3 ::RetrieveActivityId

WdfRequestSetActivityId