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

另請參閱

TraceLoggingActivity 類別