Bagikan melalui

Lacak File Format Pesan

  • Artikel

File format pesan pelacakan (TMF) adalah file teks terstruktur yang berisi instruksi untuk mengurai dan memformat pesan pelacakan biner yang dihasilkan penyedia pelacakan . Instruksi pemformatan disertakan dalam kode sumber penyedia pelacakan dan ditambahkan ke file simbol PDB penyedia pelacakan oleh prapemroseksi WPP.

Beberapa alat yang mencatat dan menampilkan pesan pelacakan yang diformat memerlukan file TMF. Tracefmt dan TraceView, alat WDK yang memformat dan menampilkan pesan pelacakan, dapat menggunakan file TMF atau mereka dapat mengekstrak informasi pemformatan langsung dari file simbol PDB.

Anda dapat membuat file TMF dengan menggunakan Tracefmt dan menyertakan parameter -i , yang mengarahkan Tracefmt untuk membuat file TMF untuk Tracedrv. Untuk informasi selengkapnya, lihat Contoh 9: Membuat file TMF.

Jika Anda tidak memiliki file TMF untuk penyedia pelacakan, gunakan Tracepdb. Tracepdb mengekstrak instruksi pemformatan dari file simbol PDB dan membuat file TMF untuk menyimpannya. Banyak pengembang aplikasi dan driver lebih suka mengirim file TMF, daripada file simbol PDB.

Nama file TMF adalah PESAN GUID pesan yang terkait dengan file TMF tersebut. ETW menggunakan GUID pesan untuk mengaitkan pesan jejak tertentu dengan file TMF yang menyimpan instruksi pemformatannya.

File TMF berisi data berikut:

  • Nama file PDB tempat data file TMF diekstrak.

  • GUID pesan pesan pelacakan dalam file sumber dan nama file sumber.

  • Untuk setiap pesan pelacakan, entri yang menentukan jenis pesan, nama file kode sumber, nomor baris, nomor pesan, string definisi pesan, nama bendera pelacakan, dan nama fungsi C yang berisi panggilan makro.

  • Daftar variabel yang nilainya muncul dalam pesan pelacakan dan nama jenis internal terkait. Variabel diwakili oleh notasi %n dalam string definisi pesan.

Catatan File TMF dicadangkan untuk penggunaan internal, dan formatnya dapat berubah di antara versi Windows yang berbeda.