TraceLoggingThreadActivity 類別 (traceloggingactivity.h)
提供活動期間記錄 ETW 事件的支援。 事件會自動標記在此活動中或以巢狀方式標記。
繼承
TraceLoggingThreadActivity 類別會實作 _TlgActivityBase。
方法
TraceLoggingThreadActivity 類別具有這些方法。
| TraceLoggingThreadActivity：:P rovider TraceLoggingThreadActivity：:P rovider (traceloggingactivity.h) 會將句柄傳回與此活動相關聯的 TraceLogging 提供者。 |
| TraceLoggingThreadActivity：：TraceLoggingThreadActivity 初始化 TraceLoggingThreadActivity 類別的新實例。 (多載 2/2) |
| TraceLoggingThreadActivity：：TraceLoggingThreadActivity 初始化 TraceLoggingThreadActivity 類別的新實例。 (多載 1/2) |
備註
此類別的運作方式是設定每個線程變數。 只會自動標記使用中線程上發生的事件。
若要使用 TraceLogging 活動，您必須定義 TraceLoggingActivity 或 TraceLoggingThreadActivity 的實例。 建立其中一個類別的實例之後，您可以使用 建立其中一個類別的實例來操作活動記錄，您可以使用 TraceLoggingFunction、TraceLoggingWriteStart、TraceLoggingWriteStop 和 TraceLoggingWriteTagged 來管理活動記錄。 當追蹤開啟並啟動活動時，這個類別會自動建立唯一標識符。
當您開始使用 TraceLoggingThreadActivity 物件進行記錄時，任何作用中的線程都會自動巢狀於這個實例中。 此外，所有事件都會以這個物件的唯一標識碼自動記錄。
重要
只有在您可以保證此線程的所有活動都完全巢狀時，才使用這個類別。 您必須確定沒有任何子活動會外延父活動，即使在錯誤案例或邊緣案例中也是如此。
注意
在 DEBUG 組建中，如果類別偵測到不正確的活動巢狀，或 Stop 事件發生在線程上，而不是用來啟動它的線程時，類別會在其 Stop 事件期間引發判斷提示。
此類別不適用於市集應用程式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | traceloggingactivity.h |