Fonction IoSetActivityIdIrp (ntddk.h)
La routine IoSetActivityIdIrp associe un ID d’activité à un IRP.
Syntaxe
NTSTATUS IoSetActivityIdIrp(
[in] PIRP Irp,
[in, optional] LPCGUID Guid
);
Paramètres
[in] Irp
IRP à laquelle associer l’ID d’activité.
[in, optional] Guid
Pointeur vers le GUID qui représente l’ID à stocker dans l’IRP. Si la valeur est NULL, IoSetActivityIdIrp tente de récupérer l’ID d’activité du thread actif s’il s’agit du thread à l’origine de la demande.
Valeur retournée
IoSetActivityIdIrp retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles sont les suivantes.
Code de retour | Description |
---|---|
STATUS_NOT_SUPPORTED | Aucun GUID n’a été fourni et l’ID d’activité ETW n’était pas disponible. |
STATUS_UNSUCCESSFUL | Le fournisseur de suivi des E/S n’a pas été activé sur l’IRP. |
Remarques
Les pilotes doivent utiliser IoSetActivityIdIrp uniquement sur les IRP qui ont été alloués à l’aide d’IoAllocateIrp (et libérés à l’aide d’IoFreeIrp). Dans le cas contraire, une fuite de mémoire peut se produire.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows 8. |
Plateforme cible | Universal |
En-tête | ntddk.h (inclure Ntddk.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | N’importe quel niveau si un GUID est transmis, sinon PASSIVE_LEVEL. |