CreateMergedTraceFile
Essa função mescla vários arquivos de rastreamento em um único arquivo de saída.
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
Parâmetros
wszMergedFileName [in]
Especifica o nome do arquivo de rastreamento de saída.
wszTraceFileNames [in]
Ponteiro para uma matriz de arquivos de rastreamento a serem mesclados.
cTraceFileNames [in]
Contagem dos elementos na matriz wszTraceFileNames .
dwExtendedDataFlags [in]
Esses sinalizadores especificam as informações do sistema a serem injetadas no arquivo de rastreamento mesclado. Para obter mais informações sobre sinalizadores válidos, consulte Injeção personalizada de informações do sistema.
Valor Retornado
ERROR_SUCCESS indica êxito.
Os valores de erro possíveis são descritos na tabela a seguir.
| Valor do erro | Descrição |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
Possivelmente indica que o rastreamento mesclado não contém um conjunto completo de eventos de cada arquivo. |
ERROR_REVISION_MISMATCH |
Possivelmente indica que os arquivos de rastreamento que estão sendo mesclados contêm eventos com versões diferentes que não puderam ser mescladas. |
Se nenhum desses valores de erro for retornado, um código de erro do sistema será retornado.
Comentários
Você pode mesclar dois ou mais arquivos de rastreamento de sessões simultâneas que foram capturadas no mesmo computador em um único arquivo de rastreamento. Você também pode mesclar arquivos de rastreamento de outras sessões de rastreamento se esses arquivos tiverem os mesmos tempos de inicialização. Opcionalmente, a operação de mesclagem adiciona metadados relativos aos rastreamentos.
Essa função pode injetar dados estendidos em um único arquivo de rastreamento. Nesse caso, a matriz wszMergedFileName contém apenas um único elemento, que é o nome do arquivo de rastreamento.
Nota Um rastreamento de kernel não mesclado não pode decodificar símbolos corretamente.
A API é implementada somente no Unicode.
Requirements
Versões: Disponível a partir do Windows Vista. Essa estrutura é distribuída com o Windows Performance Analyzer.
Cabeçalhos: Declarado em KernelTraceControl.h. Inclua KernelTraceControl.h.
Biblioteca: Contido em KernelTraceControl.dll.