Menambahkan Makro WPP ke Penyedia Pelacakan

Untuk menambahkan bentuk default pelacakan perangkat lunak WPP ke penyedia pelacakan, seperti driver mode kernel atau aplikasi mode pengguna, tambahkan arahan praprosesor C berikut dan panggilan makro WPP ke kode sumber penyedia:

• Arahan #include dari formulir berikut ke setiap file sumber yang berisi makro WPP apa pun. Pernyataan ini mencakup file header pesan pelacakan yang dibuat oleh pra-prosesor WPP untuk setiap file sumber:

  #include <source-file-name.tmh>
  

  File header pesan pelacakan harus disertakan dalam file sumber sebelum makro WPP memanggil dan setelah menentukan makro WPP_CONTROL_GUIDS .

• Definisi WPP_CONTROL_GUIDS direktif ke setiap file sumber yang menyertakan makro WPP lainnya.

  Definisi ini menentukan GUID kontrol driver dan nama bendera pelacakan yang ditentukan driver. Definisi harus ditambahkan ke file sumber sebelum pernyataan #include yang menyertakan file header pesan jejak file.

• Satu WPP_INIT_TRACING panggilan makro ke kode sumber driver.

  Untuk driver, makro ini mengaktifkan pelacakan perangkat lunak pada driver. Makro ini biasanya dipanggil selama inisialisasi driver, misalnya dalam rutinitas DriverEntry .

  Untuk aplikasi mode pengguna, panggil makro ini pada titik dalam kode sumber Anda di mana tidak ada upaya pelacakan yang telah dilakukan sebelumnya.

  Setelah inisialisasi, Anda dapat menggunakan TraceView atau Tracelog untuk memulai sesi pelacakan perangkat lunak dan untuk menampilkan pesan pelacakan.

• Satu WPP_CLEANUP panggilan makro ke kode sumber penyedia pelacakan . Makro ini menonaktifkan pelacakan perangkat lunak pada pengandar.

  Untuk driver, panggilan makro ini biasanya ditambahkan ke rutinitas Bongkar muat driver.

  Untuk aplikasi mode pengguna, panggil makro ini pada titik dalam kode sumber Anda setelah upaya pelacakan terakhir dilakukan.

• Panggilan makro DoTraceMessage untuk mencatat pesan jejak.