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 |