EtwActivityIdControl-Funktion (wdm.h)

  • Artikel

Die EtwActivityIdControl-Funktion erstellt, fragt ab und legt den aktuellen Aktivitätsbezeichner fest.

Syntax

NTSTATUS EtwActivityIdControl(
  [in]      ULONG  ControlCode,
  [in, out] LPGUID ActivityId
);

Parameter

[in] ControlCode

Der ControlCode-Parameter kann einer der folgenden definierten Werte sein.

Wert Bedeutung
EVENT_ACTIVITY_CTRL_GET_ID Gibt den Aktivitätsbezeichner des aktuellen Threads im ActivityId-Parameter zurück.
EVENT_ACTIVITY_CTRL_SET_ID Legt den Aktivitätsbezeichner des aktuellen Threads auf den in ActivityId angegebenen Wert fest. Beachten Sie, dass die ActivityId , die Sie an diese Funktion übergeben, nicht unbedingt eine von EVENT_ACTIVITY_CTRL_CREATE_ID oder EVENT_ACTIVITY_CTRL_CREATE_SET_ID Steuerelementcode erstellt werden muss. Sie können jeden Wert verwenden, der in eine GUID passt, einschließlich aller verfügbaren lokalen Werte, die Ihren Anforderungen für einen Bestimmten Typ von Aktivitätsbezeichner dienen.
EVENT_ACTIVITY_CTRL_CREATE_ID Erstellt einen neuen Bezeichner und legt den ActivityId-Parameter auf den Wert des neuen Bezeichners fest.
EVENT_ACTIVITY_CTRL_GET_SET_ID Legt den Aktivitätsbezeichner des aktuellen Threads auf den in ActivityId angegebenen Wert fest und gibt anschließend ActivityId mit dem Wert des Aktivitätsbezeichners des Threads vor dem Funktionsaufruf zurück.
EVENT_ACTIVITY_CTRL_CREATE_SET_ID Kopiert den Aktivitätsbezeichner des aktuellen Threads. Erstellt einen neuen Bezeichner und legt den Aktivitätsbezeichner des aktuellen Threads auf den neuen Wert fest. Gibt ActivityId mit dem Wert des Aktivitätsbezeichners des Threads vor dem Funktionsaufruf zurück.

[in, out] ActivityId

Der Bezeichner, der die dem Ereignis zugeordnete Aktivität angibt. Der ActivityId-Parameter bietet eine Möglichkeit zum Gruppieren verwandter Ereignisse und wird in der End-to-End-Ablaufverfolgung verwendet.

Rückgabewert

EtwActivityIdControl gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück.

Hinweise

Aktivitätsbezeichner bieten eine Methode zum Verknüpfen separater Ereignisse in einem gemeinsamen Berechnungsthread. Eine Aktivität ist ein Arbeitselement, das von einer Anwendung oder einem Treiber ausgeführt wird. Das Konzept der Aktivität ist eine Kernkomponente der End-to-End-Ablaufverfolgung.

Aufrufer von EtwActivityIdControl müssen am IRQL-DISPATCH_LEVEL < ausgeführt werden, es sei denn, der ControlCode ist EVENT_ACTIVITY_CTRL_CREATE_ID. In diesem Fall kann die Funktion in jedem IRQL aufgerufen werden.

Verwenden Sie die EtwActivityIdControlKernel-Funktion , um Kernelthreads für Aktivitätsbezeichner abzufragen oder festzulegen.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header wdm.h (include Wdm.h, Ntddk.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe; Ntdll.dll
IRQL Siehe Abschnitt "Kommentare".

Weitere Informationen

EtwActivityIdControlKernel