!wmitrace.start

Ekstensi !wmitrace.start memulai pencatat Pelacakan Peristiwa untuk Windows (ETW) pada komputer target.

!wmitrace.start LoggerName [-cir Size | -seq Size] [-f File] [-b Size] [-max Num] [-min Num] [-kd] [-ft Time] 

Parameter

LoggerName
Menyediakan nama yang akan digunakan untuk sesi pelacakan. LoggerName tidak boleh berisi spasi atau tanda kutip.

-Cir Tingginya
Menyebabkan file log ditulis secara melingkar. Ukuran menentukan ukuran file maksimum, dalam byte. Ketika file mencapai panjang ini, data baru akan ditulis ke file secara melingkar, menimpa file dari awal hingga akhir. Ini tidak dapat dikombinasikan dengan parameter -seq . Jika tidak ada -cir atau -seq yang ditentukan, file ditulis dalam mode buffer.

-seq Num
Menyebabkan file log ditulis secara berurutan. Ukuran menentukan ukuran file maksimum, dalam byte. Ketika file mencapai panjang ini, data terlama akan dihapus dari awal file setiap kali data baru ditambahkan ke akhir. Ini tidak dapat dikombinasikan dengan parameter -cir . Jika tidak ada -cir atau -seq yang ditentukan, file ditulis dalam mode buffer.

-f Arsip
Menentukan nama file log yang akan dibuat pada komputer target. File harus menyertakan jalur direktori absolut, dan tidak boleh berisi spasi atau tanda kutip.

-b Tingginya
Menentukan ukuran setiap buffer, dalam kilobyte. Rentang Ukuran yang diizinkan adalah antara 1 dan 2048, inklusif.

-Maks Num
Menentukan jumlah maksimum buffer yang akan digunakan. Num dapat berupa bilangan bulat positif apa pun.

-Min Num
Menentukan jumlah minimum buffer yang akan digunakan. Num dapat berupa bilangan bulat positif apa pun.

-Kd
Mengaktifkan mode filter KD. Pesan akan dikirim ke debugger kernel dan ditampilkan di layar.

-Ft Waktu
Menentukan durasi timer flush, dalam hitungan detik. Mulai dari Windows 8, Anda dapat menentukan durasi timer flush dalam milidetik dengan menambahkan ms ke nilai Waktu . Misalnya, -ft 100ms.

Catatan Jika Anda memulai sesi pelacakan dalam mode filter KD (-kd), buffer jejak pada komputer target dikirim ke debugger di komputer host untuk ditampilkan. Parameter ini menentukan seberapa sering buffer pada komputer target dibersihkan dan dikirim ke komputer host.

DLL

Wmitrace.dll.

Ekstensi ini tersedia di Windows 7 dan versi Windows yang lebih baru.

Informasi Tambahan

Untuk detail selengkapnya tentang parameter ekstensi ini, lihat Fungsi StartTraceA dan EVENT_TRACE_PROPERTIES. Untuk gambaran umum konseptual pelacakan peristiwa, lihat Microsoft Windows SDK. Untuk informasi tentang alat pelacakan, lihat Windows Driver Kit (WDK).

Keterangan

Setelah menggunakan ekstensi ini, Anda harus melanjutkan eksekusi program (misalnya, dengan menggunakan perintah g (Go) agar berlaku. Setelah beberapa saat, komputer target secara otomatis masuk ke debugger lagi.

Ketika sesi pelacakan dimulai, sistem menetapkan nomor ordinal (ID pencatat). Sesi kemudian dapat dirujuk baik dengan nama pencatat atau ID pencatat.

Untuk menghentikan pencatat ETW, gunakan !wmitrace.stop.