struktur EVENT_TRACE (evntrace.h)

Artikel
08/23/2023

Struktur EVENT_TRACE digunakan untuk mengirimkan informasi peristiwa ke konsumen pelacakan peristiwa.

Sintaks

typedef struct _EVENT_TRACE {
  EVENT_TRACE_HEADER Header;
  ULONG              InstanceId;
  ULONG              ParentInstanceId;
  GUID               ParentGuid;
  PVOID              MofData;
  ULONG              MofLength;
  union {
    ULONG              ClientContext;
    ETW_BUFFER_CONTEXT BufferContext;
  } DUMMYUNIONNAME;
} EVENT_TRACE, *PEVENT_TRACE;

Anggota

Header

Struktur EVENT_TRACE_HEADER yang berisi informasi pelacakan peristiwa standar.

InstanceId

Pengidentifikasi instans. Berisi data yang valid saat penyedia memanggil fungsi TraceEventInstance untuk menghasilkan peristiwa. Jika tidak, nilainya adalah nol.

ParentInstanceId

Pengidentifikasi instans untuk peristiwa induk. Berisi data yang valid saat penyedia memanggil fungsi TraceEventInstance untuk menghasilkan peristiwa. Jika tidak, nilainya adalah nol.

ParentGuid

GUID kelas dari peristiwa induk. Berisi data yang valid saat penyedia memanggil fungsi TraceEventInstance untuk menghasilkan peristiwa. Jika tidak, nilainya adalah nol.

MofData

Arahkan ke awal data khusus peristiwa untuk peristiwa ini.

MofLength

Jumlah byte yang dituju MofData .

DUMMYUNIONNAME

DUMMYUNIONNAME.ClientContext

Dicadangkan.

DUMMYUNIONNAME.BufferContext

Menyediakan informasi tentang peristiwa seperti pengidentifikasi sesi dan nomor prosesor CPU tempat proses penyedia berjalan. Untuk detailnya, lihat struktur ETW_BUFFER_CONTEXT .

Sebelum Windows Vista: Tidak didukung.

Keterangan

ProcessTrace meneruskan struktur ini ke fungsi panggilan balik EventCallback konsumen.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	evntrace.h

Lihat juga

EventCallback

Bagikan melalui