Funzione IoSetActivityIdIrp (ntddk.h)

Articolo
08/07/2023

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

Sintassi

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

Parametri

[in] Irp

IRP per associare l'ID attività a.

[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 è stato il thread che ha originariamente emesso la richiesta.

Valore restituito

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

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

Commenti

I driver devono usare IoSetActivityIdIrp solo in IRP allocati usando IoAllocateIrp (e liberati con IoFreeIrp). In caso contrario, la perdita di memoria può causare.

Requisiti

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