Funzione IoSetActivityIdIrp (ntddk.h)

Articolo
02/07/2025

La routine IoSetActivityIdIrp associa un ID attività a un IRP.

Sintassi

NTSTATUS IoSetActivityIdIrp(
  [in]           PIRP    Irp,
  [in, optional] LPCGUID Guid
);

Parametri

[in] Irp

IRP a cui associare l'ID attività.

[in, optional] Guid

Puntatore al GUID che rappresenta l'ID da archiviare in IRP. Se NULL, IoSetActivityIdIrp tenta di recuperare l'ID attività dal thread corrente se si tratta del thread che ha originariamente emesso la richiesta.

Valore restituito

IoSetActivityIdIrp restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti di errore possibili includono quanto segue.

Codice restituito	Descrizione
STATUS_NOT_SUPPORTED	Non è stato specificato alcun GUID e l'ID attività ETW non era disponibile.
STATUS_UNSUCCESSFUL	Il provider di traccia di I/O non è stato abilitato in IRP.

Osservazioni

I driver devono usare IoSetActivityIdIrp solo per i runtime di integrazione allocati usando IoAllocateIrp (e liberati usando IoFreeIrp). In caso contrario, potrebbe verificarsi una perdita di memoria.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 8.
piattaforma di destinazione	Universale
intestazione	ntddk.h (include Ntddk.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	Qualsiasi livello se viene passato un GUID; in caso contrario, PASSIVE_LEVEL.

Condividi tramite