EtwActivityIdControl 函式 (wdm.h)

EtwActivityIdControl 函式會建立、查詢及設定目前的活動標識碼。

語法

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

[in] ControlCode

ControlCode 參數可以是下列其中一個定義的值。

值	意義
EVENT_ACTIVITY_CTRL_GET_ID	傳回 ActivityId 參數中目前線程的活動標識碼。
EVENT_ACTIVITY_CTRL_SET_ID	將目前線程的活動標識碼設定為 ActivityId 中指定的值。請注意，您傳遞至此函式的 ActivityId 不一定是由 EVENT_ACTIVITY_CTRL_CREATE_ID 或 EVENT_ACTIVITY_CTRL_CREATE_SET_ID 控件程式碼所建立。您可以使用任何符合 GUID 內的值，包括任何可用的本機值，以符合某種類型的活動識別碼需求。
EVENT_ACTIVITY_CTRL_CREATE_ID	建立新的標識碼，並將 ActivityId 參數設定為新標識碼的值。
EVENT_ACTIVITY_CTRL_GET_SET_ID	將目前線程的活動標識碼設定為 ActivityId 中指定的值，然後在函式呼叫之前傳回具有線程活動識別碼值的 ActivityId 。
EVENT_ACTIVITY_CTRL_CREATE_SET_ID	複製目前線程的活動標識碼。建立新的標識碼，並將目前線程的活動標識碼設定為新的值。傳回 ActivityId ，其值為函式呼叫之前線程的活動識別碼。

[in, out] ActivityId

標識符，表示與事件相關聯的活動。 ActivityId 參數提供將相關事件分組的方式，並用於端對端追蹤。

EtwActivityIdControl 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值。

活動標識碼提供在一般計算線程中鏈接個別事件的方法。活動是由應用程式和或驅動程序執行的工作專案。活動的概念是端對端追蹤的核心元件。

EtwActivityIdControl 的呼叫端必須在 IRQL < DISPATCH_LEVEL上執行，除非 ControlCode 是EVENT_ACTIVITY_CTRL_CREATE_ID，在此情況下，可以在任何 IRQL 呼叫函式。

使用 EtwActivityIdControlKernel 函式來查詢或設定活動識別碼核心線程。