EtwActivityIdControl-Funktion (wdm.h)
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". |