Fonction IoSetActivityIdIrp (ntddk.h)

Article
02/07/2025

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 à 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é à partir du thread actuel s’il s’agissait du thread qui a initialement émis la requête.

Valeur de retour

IoSetActivityIdIrp retourne STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles sont les suivantes.

Retourner le code	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 d’E/S n’a pas été activé sur l’IRP.

Remarques

Les pilotes doivent utiliser IoSetActivityIdIrp uniquement sur les irPs qui ont été alloués à l’aide de IoAllocateIrp (et libérés à l’aide de IoFreeIrp). Sinon, la fuite de mémoire peut se produire.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	ntddk.h (include Ntddk.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau si un GUID est passé, sinon PASSIVE_LEVEL.

Partager via