ITracer インターフェイス (wdtf.h)
ITracer インターフェイスを使用すると、すべての WDTF インターフェイスの個々のインスタンスで、特定の実装コクラスの特定のトレース設定を決定できます。 これらの設定はレジストリに記録されます。
継承
ITracer インターフェイスは、IDispatch インターフェイスから継承されます。 ITracer には、次の種類のメンバーもあります。
- メソッド
メソッド
ITracer インターフェイスには、これらのメソッドがあります。
| ITracer::GetBits GetBits メソッドは、指定された TTraceLevel 値とコクラスの CLSID を指定して、コクラスのトレース フラグのセットをビット マスクとして返します。 |
注釈
通常、 ITracer インターフェイスは表示されません。 実際、WDTF アクション プラグインを構築している場合でも、おそらくこのインターフェイスを使用する必要はありません。 ITracer は WDTF.dll で実装され、各 TTraceLevel 列挙値に関連付けられている特定の設定のグローバル定義を提供します。
次の表では、WDTF トレースの内部フラグについて説明します。 TTraceLevel 列挙内の個々のレベルは、内部トレース フラグのセットに対応します。 TraceLevel パス (次の実装の詳細セクション) に一覧表示されているレジストリ キーには、次の表に示すように、各 TTraceLevel のビット マスクが含まれています。
Trace2_MediumにはすべてのTrace1_Lowフラグが含まれており、Trace3_HighにはすべてのTrace2_Mediumフラグが含まれます。
| トレース フラグ | 意味 | ビット | 既定のトレース レベル |
|---|---|---|---|
| COMEntryExit | 入力と終了の COM メソッドまたはプロパティ | 0x0001 | Trace1_Low |
| COMError | COM メソッドまたはプロパティによってエラーが見つかりました | 0x0002 | Trace1_Low |
| EntryExit | 入退出のための C++ 関数 | 0x0004 | Trace2_Medium |
| APICall | API の呼び出しについて | 0x0008 | Trace2_Medium |
| Info | 追加情報 | 0x0010 | Trace2_Medium |
| 警告 | 何かが間違っている可能性があることを警告する | 0x0020 | Trace1_Low |
| エラー | WDTF 内でエラーが見つかりました | 0x0040 | Trace1_Low |
| NoisyCOMEntryExit | COMError フラグのノイズの多いバージョン | 0x0080 | Trace3_High |
| NoisyEntryExit | EntryExit フラグのノイズの多いバージョン | 0x0100 | Trace3_High |
| NoisyAPICall | APICall フラグのノイズの多いバージョン | 0x0200 | Trace3_High |
| NoisyInfo | 情報フラグのノイズの多いバージョン | 0x0400 | Trace3_High |
| NoisyWarning | 警告フラグのノイズの多いバージョン | 0x0800 | Trace3_High |
実装の詳細
ProgID: WDTF。トレーサー
TraceLevel パス: HKCR\WDTF。Tracer.1\
メモITracer インターフェイスの実装はスレッド セーフです。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | wdtf.h |