CreateMergedTraceFile
Esta función combina varios archivos de seguimiento en un único archivo de salida.
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
Parámetros
wszMergedFileName [in]
Especifica el nombre del archivo de seguimiento de salida.
wszTraceFileNames [in]
Puntero a una matriz de archivos de seguimiento que se van a combinar.
cTraceFileNames [in]
Recuento de los elementos de la matriz wszTraceFileNames .
dwExtendedDataFlags [in]
Estas marcas especifican la información del sistema que se insertará en el archivo de seguimiento combinado. Para obtener más información sobre las marcas válidas, vea Inserción personalizada de información del sistema.
Valor devuelto
ERROR_SUCCESS indica que se ha realizado correctamente.
Los valores de error posibles se describen en la tabla siguiente.
| Valor de error | Descripción |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
Posiblemente indica que el seguimiento combinado no contiene un conjunto completo de eventos de cada archivo. |
ERROR_REVISION_MISMATCH |
Posiblemente indica que los archivos de seguimiento que se combinan contienen eventos con diferentes versiones que no se pudieron combinar. |
Si no se devuelve ninguno de estos valores de error, se devuelve un código de error del sistema.
Comentarios
Puede combinar dos o más archivos de seguimiento de sesiones simultáneas capturadas en el mismo equipo en un único archivo de seguimiento. También puede combinar archivos de seguimiento de otras sesiones de seguimiento si esos archivos tienen las mismas horas de arranque. Opcionalmente, la operación de combinación agrega metadatos relativos a los seguimientos.
Esta función puede insertar datos extendidos en un único archivo de seguimiento. En este caso, la matriz wszMergedFileName contiene solo un único elemento, que es el nombre del archivo de seguimiento.
Nota Un seguimiento del kernel no combinado no puede descodificar los símbolos correctamente.
La API solo se implementa en Unicode.
Requisitos
Versiones: Disponible a partir de Windows Vista. Esta estructura se distribuye con Windows Analizador de rendimiento.
Encabezados: Declarado en KernelTraceControl.h. Incluya KernelTraceControl.h.
Biblioteca: Contenido en KernelTraceControl.dll.