CreateMergedTraceFile
この関数は、複数のトレース ファイルを 1 つの出力ファイルにマージします。
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
パラメーター
wszMergedFileName [in]
出力トレース ファイルの名前を指定します。
wszTraceFileNames [in]
マージするトレース ファイルの配列のポインター。
cTraceFileNames [in]
wszTraceFileNames 配列内の要素の数。
dwExtendedDataFlags [in]
これらのフラグは、マージされたトレース ファイルに挿入されるシステム情報を指定します。 有効なフラグの詳細については、「システム情報のカスタム挿入」を参照してください。
戻り値
ERROR_SUCCESS は成功を示します。
次の表に、このオプションでエラーの可能性な値を示します。
| エラー値 | 説明 |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
おそらく、マージされたトレースに各ファイルからのイベントの完全なセットが含まれていないことを示しています。 |
ERROR_REVISION_MISMATCH |
おそらく、マージされるトレース ファイルに、マージできない異なるバージョンのイベントが含まれていることを示しています。 |
どちらのエラー値も返されない場合は、システム エラー コードが返されます。
注釈
同じコンピューターでキャプチャされた同時セッションからの 2 つ以上のトレース ファイルを 1 つのトレース ファイルにマージできます。 ファイルの起動時間が同じ場合は、他のトレース セッションのトレース ファイルをマージすることもできます。 必要に応じて、マージ操作によってトレースに関するメタデータが追加されます。
この関数は、1 つのトレース ファイルに拡張データを挿入できます。 この場合、wszMergedFileName 配列には、トレース ファイルの名前である 1 つの要素だけが含まれます。
注 マージされていないカーネル トレースでは、シンボルを正しくデコードできません。
API は Unicode でのみ実装されます。
必要条件
バージョン: Windows Vista 以降で使用できます。 この構造体は、Windows パフォーマンス アナライザーで配布されています。
ヘッダー: KernelTraceControl.h で宣言されます。 KernelTraceControl.h を含みます。
ライブラリ: KernelTraceControl.dll に含まれます。