IoSetActivityIdIrp-Funktion (ntddk.h)

  • Artikel

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.