Menulis Peristiwa Terkait di Penyedia Klasik

Penyedia klasik menggunakan fungsi TraceEventInstance untuk melacak peristiwa yang merupakan bagian dari satu transaksi. Anda juga dapat menggunakan fungsi ini untuk melacak peristiwa induk/anak.

Sebelum memanggil fungsi TraceEventInstance , Anda harus terlebih dahulu memanggil fungsi CreateTraceInstanceId untuk mendapatkan pengidentifikasi transaksi. Fungsi ini menghasilkan pengidentifikasi transaksi unik, dan memetakannya ke handel GUID kelas terdaftar. Handel untuk GUID kelas terdaftar tersedia di anggota RegHandle dari struktur TRACE_GUID_REGISTRATION , setelah memanggil fungsi RegisterTraceGuids . Pengidentifikasi transaksi ditempatkan di anggota InstanceId dari struktur EVENT_INSTANCE_INFO yang Anda berikan ke fungsi CreateTraceInstanceId .

Struktur EVENT_INSTANCE_HEADER yang diteruskan ke fungsi TraceEventInstance mirip dengan struktur EVENT_TRACE_HEADER (lihat Melacak Peristiwa), kecuali bahwa struktur tersebut berisi informasi tambahan yang berkaitan dengan instans, dan tidak berisi anggota Guid .

Instans peristiwa dapat digunakan untuk membuat hubungan hierarkis antar peristiwa. Fungsi TraceEventInstance menerima informasi khusus instans dari dua instans peristiwa. Parameter pInstInfo menunjuk ke struktur EVENT_INSTANCE_INFO instans peristiwa, dan parameter pParentInstInfo menunjuk ke struktur EVENT_INSTANCE_INFO instans peristiwa induk. Definisi instans peristiwa "induk" ditentukan aplikasi; induk dapat menjadi instans apa pun yang telah dibuat.