CreateMergedTraceFile
Cette fonction fusionne plusieurs fichiers de trace en un seul fichier de sortie.
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
Paramètres
wszMergedFileName [in]
Spécifie le nom du fichier de trace de sortie.
wszTraceFileNames [in]
Pointeur vers un tableau de fichiers de trace à fusionner.
cTraceFileNames [in]
Nombre d’éléments dans le tableau wszTraceFileNames .
dwExtendedDataFlags [in]
Ces indicateurs spécifient les informations système à injecter dans le fichier de trace fusionné. Pour plus d’informations sur les indicateurs valides, consultez Injection personnalisée d’informations système.
Valeur de retour
ERROR_SUCCESS indique la réussite.
Les valeurs d’erreur possibles sont décrites dans le tableau suivant.
| Valeur d’erreur | Description |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
Indique éventuellement que la trace fusionnée ne contient pas un ensemble complet d’événements de chaque fichier. |
ERROR_REVISION_MISMATCH |
Indique éventuellement que les fichiers de trace en cours de fusion contiennent des événements avec des versions différentes qui n’ont pas pu être fusionnées. |
Si aucune de ces valeurs d’erreur n’est retournée, un code d’erreur système est retourné.
Notes
Vous pouvez fusionner deux fichiers de trace ou plus à partir de sessions simultanées qui ont été capturées sur le même ordinateur dans un seul fichier de trace. Vous pouvez également fusionner des fichiers de suivi à partir d’autres sessions de suivi si ces fichiers ont les mêmes heures de démarrage. Si vous le souhaitez, l’opération de fusion ajoute des métadonnées concernant les traces.
Cette fonction peut injecter des données étendues dans un fichier de trace unique. Dans ce cas, le tableau wszMergedFileName ne contient qu’un seul élément, qui est le nom du fichier de trace.
Note Une trace de noyau non fusionnée ne peut pas décoder correctement les symboles.
L’API est implémentée uniquement dans Unicode.
Configuration requise
Versions: Disponible à partir de Windows Vista. Cette structure est distribuée avec windows Analyseur de performances.
En-têtes: Déclaré dans KernelTraceControl.h. Incluez KernelTraceControl.h.
Bibliothèque: Contenu dans KernelTraceControl.dll.