CreateMergedTraceFile
此函式會將多個追蹤檔案合併成單一輸出檔。
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 |
可能表示正在合併的追蹤檔案包含不同版本無法合併的事件。 |
如果未傳回這些錯誤值，則會傳回系統錯誤碼。
備註
您可以從在同一部電腦上擷取的同時會話，將兩個或多個追蹤檔案合併成單一追蹤檔案。 如果這些檔案具有相同的開機時間，您也可以合併來自其他追蹤會話的追蹤檔案。 選擇性地，合併作業會新增有關追蹤的中繼資料。
此函式可以將擴充資料插入單一追蹤檔案。 在此情況下， wszMergedFileName 陣列只包含單一元素，這是追蹤檔案的名稱。
注意 未合併的核心追蹤無法正確解碼符號。
API 只會在 Unicode 中實作。
需求
版本： 從 Windows Vista 開始提供。 此結構會與 Windows 效能分析器一起散發。
頭： 在 KernelTraceControl.h 中宣告。 包含 KernelTraceControl.h。
圖書館： 包含在KernelTraceControl.dll中。