CreateMergedTraceFile
Fungsi ini menggabungkan beberapa file jejak ke dalam satu file output.
ULONG
WINAPI
CreateMergedTraceFile(
__in LPCWSTR wszMergedFileName,
__in LPCWSTR wszTraceFileNames[],
__in ULONG cTraceFileNames,
__in DWORD dwExtendedDataFlags
);
Parameter
wszMergedFileName [in]
Menentukan nama file pelacakan output.
wszTraceFileNames [in]
Penunjuk ke array file jejak yang akan digabungkan.
cTraceFileNames [in]
Jumlah elemen dalam array wszTraceFileNames .
dwExtendedDataFlags [in]
Bendera ini menentukan informasi sistem yang akan disuntikkan ke dalam file pelacakan gabungan. Untuk informasi selengkapnya tentang bendera yang valid, lihat Injeksi Kustom Informasi Sistem.
Tampilkan Nilai
ERROR_SUCCESS menunjukkan keberhasilan.
Nilai kesalahan yang mungkin dijelaskan dalam tabel berikut ini.
| Nilai Kesalahan | Deskripsi |
|---|---|
ERROR_INSUFFICIENT_BUFFER |
Mungkin menunjukkan bahwa jejak gabungan tidak berisi serangkaian peristiwa lengkap dari setiap file. |
ERROR_REVISION_MISMATCH |
Mungkin menunjukkan bahwa file jejak yang digabungkan berisi peristiwa dengan versi berbeda yang tidak dapat digabungkan. |
Jika tidak satu pun dari nilai kesalahan ini dikembalikan, kode kesalahan sistem dikembalikan.
Keterangan
Anda dapat menggabungkan dua atau beberapa file pelacakan dari sesi simultan yang diambil di komputer yang sama ke dalam satu file pelacakan. Anda juga dapat menggabungkan file pelacakan dari sesi pelacakan lain jika file tersebut memiliki waktu boot yang sama. Secara opsional, operasi penggabungan menambahkan metadata mengenai jejak.
Fungsi ini dapat menyuntikkan data yang diperluas ke dalam satu file pelacakan. Dalam hal ini array wszMergedFileName hanya berisi satu elemen, yang merupakan nama file jejak.
Catatan Jejak kernel yang tidak tergabung tidak dapat mendekode simbol dengan benar.
API hanya diimplementasikan di Unicode.
Persyaratan
Versi: Tersedia dimulai di Windows Vista. Struktur ini didistribusikan dengan Penganalisis Kinerja Windows.
Header: Dideklarasikan dalam KernelTraceControl.h. Sertakan KernelTraceControl.h.
Perpustakaan: Terkandung dalam KernelTraceControl.dll.