Fonction IoSetActivityIdIrp (ntddk.h)

  • Article

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.