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) |
注釈
このクラスは、スレッドごとの変数を設定することで機能します。 アクティブなスレッドで発生するイベントのみが自動的にタグ付けされます。
トレース ログ アクティビティを使用するには、 TraceLoggingActivity または TraceLoggingThreadActivity のいずれかのインスタンスを定義 する必要があります。 これらのクラスのいずれかのインスタンスを作成したら、 を使用してアクティビティ ログを操作します。これらのクラスのいずれかのインスタンスを作成したら、TraceLoggingFunction、TraceLoggingWriteStart、TraceLoggingWriteStop、TraceLoggingWriteTagged を使用してアクティビティ ログを操作します。 このクラスは、トレースが有効になっていてアクティビティが開始されると、一意の識別子を自動的に作成します。
TraceLoggingThreadActivity オブジェクトを使用してログ記録を開始すると、アクティブなスレッドはこのインスタンスに自動的に入れ子になります。 さらに、すべてのイベントは、このオブジェクトの一意識別子で自動的にログに記録されます。
重要
このクラスは、このスレッドのすべてのアクティビティが完全に入れ子になっていることを保証できる場合にのみ使用します。 エラーケースやエッジケースであっても、子アクティビティが親アクティビティを上回らないようにする必要があります。
注意
DEBUG ビルドでは、クラスは Stop イベント中、不適切なアクティビティの入れ子を検出した場合、または Stop イベントが開始に使用されたスレッド以外のスレッドで発生した場合にアサーションを発生させます。
このクラスは、ストア アプリケーションでは使用できません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | traceloggingactivity.h |