!wmitrace.searchpath

Ekstensi !wmitrace.searchpath menentukan lokasi file format pesan pelacakan untuk pesan dalam buffer pelacakan.

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

Parameter

+
Menyebabkan TMFPath ditambahkan ke jalur pencarian yang ada. Jika token plus (+) tidak digunakan, TMFPath menggantikan jalur pencarian yang ada.

TMFPath
Jalur ke direktori tempat debugger harus mencari file format pesan pelacakan. Jalur yang berisi spasi tidak didukung. Jika beberapa jalur disertakan, jalur harus dipisahkan oleh titik koma, dan seluruh string harus diapit dalam tanda kutip. Jika jalur dalam tanda kutip, karakter garis miring terbalik harus didahului oleh karakter escape ( "c:\\debuggers;c:\\debuggers2" ). + Ketika token digunakan, TMFPath akan ditambahkan ke jalur yang ada, dengan titik koma secara otomatis dimasukkan antara jalur yang ada dan jalur baru; namun, jika + token digunakan, tanda kutip tidak dapat digunakan.

DLL

Wmitrace.dll

Ekstensi ini tersedia di Windows 2000 dan versi Windows yang lebih baru. Jika Anda ingin menggunakan ekstensi ini dengan Windows 2000, Anda harus terlebih dahulu menyalin file Wmitrace.dll dari subdirektori winxp dari direktori Penginstalan Alat Debugging untuk Windows ke subdirektori w2kfre.

Informasi Tambahan

Untuk gambaran umum konseptual pelacakan peristiwa, lihat Microsoft Windows SDK. Untuk informasi tentang melacak file format pesan, lihat topik "Lacak File Format Pesan" di Windows Driver Kit (WDK).

Keterangan

Ketika digunakan tanpa parameter, !wmitrace.searchpath menampilkan jalur pencarian saat ini.

File format pesan pelacakan (*.tmf) berisi instruksi untuk memformat pesan jejak biner yang dihasilkan penyedia pelacakan.

Parameter TMFPath hanya boleh berisi jalur ke direktori; parameter tidak dapat menyertakan nama file. Nama file TMF adalah GUID pesan yang diikuti oleh ekstensi .tmf. Ketika sistem memformat pesan, sistem membaca pesan GUID pada pesan dan mencari secara rekursif untuk file TMF yang namanya cocok dengan GUID pesan, dimulai di direktori yang ditentukan.

Windows memerlukan file TMF untuk memformat pesan pelacakan biner dalam buffer. Gunakan !wmitrace.searchpath atau !wmitrace.tmffile untuk menentukan file TMF sebelum menggunakan !wmitrace.dynamicprint atau !wmitrace.logdump untuk menampilkan isi buffer pelacakan.

Jika Anda tidak menggunakan !wmitrace.searchpath atau !wmitrace.tmffile, sistem menggunakan nilai variabel lingkungan TRACE_FORMAT_SEARCH_PATH. Jika variabel tersebut tidak ada, variabel tersebut menggunakan file default.tmf, yang disertakan dalam Windows. Jika sistem tidak dapat menemukan informasi pemformatan apa pun untuk pesan pelacakan, sistem menulis pesan kesalahan "Tidak ada informasi format yang ditemukan" sebagai pengganti isi pesan pelacakan.