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 реализован только в Юникоде.
Requirements
Версии: Доступно начиная с Windows Vista. Эта структура распределяется с windows Анализатор производительности.
Заголовки: Объявлено в KernelTraceControl.h. Включите KernelTraceControl.h.
Библиотека: Содержится в KernelTraceControl.dll.