システム情報のカスタム挿入
カーネル トレース制御を使用すると、複数のトレース ファイルを 1 つの出力トレース ファイルに統合するときに、システム情報のカスタム挿入を行うことができます。 システム情報を含めるには、単一のフラグまたはフラグの組み合わせを CreateMergedTraceFile 関数に設定します。 次のフラグが、統合後のトレース ファイルに追加するシステム情報を定義します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_NONE 0x00000000
統合後のトレース ファイルに追加するシステム情報はありません。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_IMAGEID 0x00000001
シンボル参照時に使用されるチェックサムやタイムスタンプなどのイメージ情報を挿入します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_BUILDINFO 0x00000002
製品名やビルド環境など、オペレーティング システムのビルド情報を挿入します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_VOLUME_MAPPING 0x00000004
MS-DOS のパスと Windows NT のパスの間にボリューム マッピングを挿入します。 イベントのペイロードには、NULL で終わる Unicode 文字列を 2 つ格納します。 1 つ目の文字列には Windows NT のパスを格納し、2 つ目の文字列には MS-DOS のパスを格納します。 ペイロードの長さは、NULL 文字を含む 2 つの文字列のサイズ (バイト単位) です。
たとえば、Windows NT のパス "\Device\HarddiskVolume1\" が MS-DOS のパス "C:\" に変換されます。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_WINSAT 0x00000008
WinSat 情報を挿入します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_EVENT_METADATA 0x00000010
イベントを分析しているコンピューター以外のコンピューターでキャプチャされるイベントのトレース データ ヘッダー (TDH) メタデータを挿入します。 トレース データ ヘッダー情報の詳細については、「イベント トレーシング」を参照してください。
#define EVENT_METADATA_LOG_TYPE_TRACE_EVENT_INFO 0x20
EVENT_TRACE_MERGE_EXTENDED_DATA_EVENT_METADATA によりログに記録されるイベントを識別するトレース情報を挿入します。
#define EVENT_METADATA_LOG_TYPE_EVENT_MAP_INFO 0x21
EVENT_TRACE_MERGE_EXTENDED_DATA_EVENT_METADATA フラグを設定した結果としてログに記録されるイベントのメタデータを定義する情報を挿入します。 詳細については、EVENT_MAP_INFO 構造体を参照してください。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_PERFTRACK_METADATA 0x00000020
異なるコンピューター上での PerfTrack イベントのデコードのために、PerfTrack イベントのメタデータを挿入します。 これらのイベントは、Windows 7 と Windows Server 2008 でのみ挿入されます。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_DEFAULT 0x000FFFFF
イメージ、ビルド、ボリューム マッピング、WinSat,、イベント メタデータ、PerfTrack メタデータのデータを挿入します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_ALL 0xFFFFFFF
すべての拡張データ情報を出力トレース ファイルに挿入します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_NETWORK_INTERFACE 0x00000040
ネットワーク インターフェイス情報を挿入します。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_NGEN_PDB 0x00000080
PDB を作成して、トレースに表示される NGEN バイナリのシンボル読み込みを有効にします。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_COMPRESS_TRACE 0x10000000
統合したトレースを圧縮します。 Windows 8 以上でのみサポートされます。
#define EVENT_TRACE_MERGE_EXTENDED_DATA_INJECT_ONLY 0x40000000
イメージ識別情報のみを挿入し、入力トレースからイベントをコピーしません。
解説
要件:
バージョン: Windows Vista 以降で使用できます。 この構造体は、Windows パフォーマンス アナライザーで配布されています。
ヘッダー: KernelTraceControl.h で宣言されます。 KernelTraceControl.h を含みます。
ライブラリ: KernelTraceControl.dll に含まれます。