IWDFIoRequest3 ::SetActivityId, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode SetActivityId associe un identificateur d’activité à une requête d’E/S.
Syntaxe
void SetActivityId(
[in] LPGUID ActivityId
);
Paramètres
[in] ActivityId
Pointeur vers le GUID de l’identificateur d’activité à stocker dans la requête d’E/S.
Valeur de retour
Aucun
Remarques
L’appel SetActivityId ne définit pas d’association avec un identificateur d’activité présent précédemment. 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 ne 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.11 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |