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 函式來查詢或設定活動識別碼核心線程。