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 数组仅包含单个元素，即跟踪文件的名称。
注意 未合并的内核跟踪无法正确解码符号。
仅在 Unicode 中实现 API。
要求
版本：从 Windows Vista 开始提供。 此结构随 Windows Performance Analyzer 一起分发。
标头：在 KernelTraceControl.h 中声明。 包括 KernelTraceControl.h。
库：在 KernelTraceControl.dll 中声明。