CreateMergedTraceFile
Questa funzione unisce più file di traccia in un singolo file di output.
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
Parametri
wszMergedFileName [in]
Specifica il nome del file di traccia di output.
wszTraceFileNames [in]
Puntatore a una matrice di file di traccia da unire.
cTraceFileNames [in]
Conteggio degli elementi nella matrice wszTraceFileNames .
dwExtendedDataFlags [in]
Questi flag specificano le informazioni di sistema da inserire nel file di traccia unito. Per altre informazioni sui flag validi, vedere Inserimento personalizzato delle informazioni di sistema.
Valore restituito
ERROR_SUCCESS indica l'esito positivo.
I valori di errore possibili sono descritti nella tabella seguente.
| Valore errore | Descrizione |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
Probabilmente indica che la traccia unita non contiene un set completo di eventi da ogni file. |
ERROR_REVISION_MISMATCH |
Indica probabilmente che i file di traccia uniti contengono eventi con versioni diverse che non è stato possibile unire. |
Se nessuno di questi valori di errore viene restituito, viene restituito un codice di errore di sistema.
Commenti
È possibile unire due o più file di traccia da sessioni simultanee acquisite nello stesso computer in un singolo file di traccia. È anche possibile unire file di traccia da altre sessioni di traccia se tali file hanno gli stessi tempi di avvio. Facoltativamente, l'operazione di merge aggiunge metadati relativi alle tracce.
Questa funzione può inserire dati estesi in un singolo file di traccia. In questo caso la matrice wszMergedFileName contiene solo un singolo elemento, ovvero il nome del file di traccia.
Nota Una traccia del kernel nonmerged non è in grado di decodificare correttamente i simboli.
L'API viene implementata solo in Unicode.
Requisiti
Versioni: Disponibile a partire da Windows Vista. Questa struttura viene distribuita con Windows analizzatore prestazioni.
Intestazioni: Dichiarato in KernelTraceControl.h. Includere KernelTraceControl.h.
Libreria: Contenuto in KernelTraceControl.dll.