IoSetActivityIdIrp-Funktion (ntddk.h)

Artikel
02/26/2024

Die IoSetActivityIdIrp-Routine ordnet eine Aktivitäts-ID einem IRP zu.

Syntax

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

Parameter

[in] Irp

Der IRP, dem die Aktivitäts-ID zugeordnet werden soll.

[in, optional] Guid

Ein Zeiger auf die GUID, die die ID darstellt, die im IRP gespeichert werden soll. Bei NULL versucht IoSetActivityIdIrp, die Aktivitäts-ID aus dem aktuellen Thread abzurufen, wenn es sich um den Thread handelt, der die Anforderung ursprünglich ausgestellt hat.

Rückgabewert

IoSetActivityIdIrp gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_NOT_SUPPORTED	Es wurde keine GUID bereitgestellt, und die ETW-Aktivitäts-ID war nicht verfügbar.
STATUS_UNSUCCESSFUL	Der E/A-Ablaufverfolgungsanbieter wurde für die IRP nicht aktiviert.

Hinweise

Treiber sollten IoSetActivityIdIrp nur für IRPs verwenden, die mithilfe von IoAllocateIrp zugewiesen wurden (und mithilfe von IoFreeIrp freigegeben wurden). Andernfalls kann es zu Speicherverlusten führen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Zielplattform	Universell
Header	ntddk.h (include Ntddk.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Jede Ebene, wenn eine GUID übergeben wird, andernfalls PASSIVE_LEVEL.

Freigeben über