Cara Masuk ke Sesi Pencatat Global

Gunakan prosedur berikut untuk mengonfigurasi driver untuk masuk ke sesi pelacakan Global Logger:

1. Tambahkan definisi berikut ke kode driver. Sisipkan definisi antara definisi makro WPP_CONTROL_GUIDS dan pernyataan sertakan untuk file header pesan pelacakan.

   #define WPP_GLOBALLOGGER
   

2. Gunakan Tracelog untuk mengonfigurasi sesi pelacakan Global Logger. Perintah paling sederhana adalah sebagai berikut:

   tracelog -start GlobalLogger
   

   Untuk petunjuk lengkap, termasuk parameter untuk mengonfigurasi sesi pelacakan Global Logger, lihat Sintaks Perintah Tracelog dan Sesi Pelacakan Pencatat Global.

   Misalnya, lihat Contoh 13: Membuat Sesi Pencatat Global.

   Perintah ini membuat dan mengonfigurasi sesi pelacakan, tetapi sesi tidak dimulai sampai Anda memulai ulang sistem (langkah 5).

3. Di bawah subkunci HKLM\System\CurrentControlSet\Control\WMI\GlobalLogger , tambahkan subkunci bernama untuk GUID kontrol penyedia pelacakan. Di Windows Vista dan versi Windows yang lebih baru, GUID kontrol harus diapit kurung kurawal ( {} ).

   Perintah tracelog -start GlobalLogger menambahkan subkuntang GlobalLogger ke registri. Subkuntah ControlGUID menetapkan driver sebagai penyedia pelacakan untuk sesi pelacakan Global Logger.

   Misalnya, untuk mengonfigurasi driver sampel Tracedrv untuk masuk ke sesi pelacakan Global Logger di komputer yang menjalankan Windows XP, tambahkan subkunci bernama untuk GUID kontrol Tracedrv, d58c126f-b309-11d1-969e-0000f875a5bc: HKLM\SYSTEM\CurrentControlSet\Control\WMI\GlobalLogger\d58c126f-b309-11d1-969e-0000f875a5bc.

   TraceDrv, driver sampel yang dirancang untuk pelacakan perangkat lunak, tersedia di repositori sampel driver Windows di GitHub.

4. Untuk mengonfigurasi penyedia pelacakan, tambahkan entri registri berikut ke subkuntah ControlGUID . Entri ini bersifat opsional dan nilainya ditentukan oleh driver.

   Nama entri	Jenis data	Deskripsi
   Bendera	REG_DWORD	Menentukan bendera pelacakan untuk penyedia. Arti dari bendera didefinisikan secara independen oleh setiap penyedia pelacakan. Biasanya, bendera mewakili tingkat pelaporan yang semakin terperinci.
   Level	REG_DWORD	Menentukan tingkat pelacakan untuk penyedia. Arti dari nilai Tingkat didefinisikan secara independen oleh setiap penyedia pelacakan. Biasanya, tingkat pelacakan mewakili tingkat keparahan peristiwa (informasi, peringatan, atau kesalahan).

Perhatikan bahwa nama entri Bendera bersifat jamak dan nama entri Tingkat bersifat tunggal.

5. Mulai ulang sistem. Ini memulai sesi pelacakan Global Logger.

Setelah pengujian Anda selesai, hapus subkunji ControlGUID atau atur nilai entri Mulai di subkunji GlobalLogger ke 0. Jika tidak, sesi Global Logger berjalan, dan driver mencatatnya, setiap kali Anda menghidupkan ulang sistem.

Komentar

Ketika WPP_GLOBALLOGGER ada, WPP menambahkan kode yang membaca registri dan menentukan apakah sesi Global Logger berjalan dan apakah driver diaktifkan untuk melacak ke sesi Global Logger. Kode ini menggantikan pemberitahuan aktifkan yang akan diterima driver dari sesi pelacakan standar.

Selain itu, karena sesi Global Logger tidak memberikan pemberitahuan panggilan balik, Windows mengasumsikan bahwa panggilan balik telah terjadi, dan melanjutkan sesuai.

Definisi WPP hanya menghasilkan sejumlah kecil kode, sehingga tidak perlu menghapusnya dari kode setelah pengujian.