struktur TRACE_LOGFILE_HEADER (evntrace.h)
Struktur TRACE_LOGFILE_HEADER berisi informasi tentang sesi pelacakan peristiwa dan peristiwanya. Ini adalah format data mentah dari data informasi pelacakan di header file log ETW. Ini juga merupakan bagian dari informasi yang dikembalikan oleh OpenTrace dan diberikan kepada BufferCallback selama pemrosesan jejak.
Sintaks
typedef struct _TRACE_LOGFILE_HEADER {
ULONG BufferSize;
union {
ULONG Version;
struct {
UCHAR MajorVersion;
UCHAR MinorVersion;
UCHAR SubVersion;
UCHAR SubMinorVersion;
} VersionDetail;
} DUMMYUNIONNAME;
ULONG ProviderVersion;
ULONG NumberOfProcessors;
LARGE_INTEGER EndTime;
ULONG TimerResolution;
ULONG MaximumFileSize;
ULONG LogFileMode;
ULONG BuffersWritten;
union {
GUID LogInstanceGuid;
struct {
ULONG StartBuffers;
ULONG PointerSize;
ULONG EventsLost;
ULONG CpuSpeedInMHz;
} DUMMYSTRUCTNAME;
} DUMMYUNIONNAME2;
#if ...
PWCHAR LoggerName;
#if ...
PWCHAR LogFileName;
#if ...
RTL_TIME_ZONE_INFORMATION TimeZone;
#else
LPWSTR LoggerName;
#endif
#else
LPWSTR LogFileName;
#endif
#else
TIME_ZONE_INFORMATION TimeZone;
#endif
LARGE_INTEGER BootTime;
LARGE_INTEGER PerfFreq;
LARGE_INTEGER StartTime;
ULONG ReservedFlags;
ULONG BuffersLost;
} TRACE_LOGFILE_HEADER, *PTRACE_LOGFILE_HEADER;
Anggota
BufferSize
Ukuran buffer sesi pelacakan peristiwa, dalam byte.
DUMMYUNIONNAME
DUMMYUNIONNAME.Version
Nomor versi sistem operasi tempat jejak dikumpulkan. Ini adalah roll-up anggota VersionDetail. Dimulai dengan byte urutan rendah, dua byte pertama berisi MajorVersion, dua byte berikutnya berisi MinorVersion, dua byte berikutnya berisi SubVersion, dan dua byte terakhir berisi SubMinorVersion.
DUMMYUNIONNAME.VersionDetail
DUMMYUNIONNAME.VersionDetail.MajorVersion
Nomor versi utama sistem operasi tempat jejak dikumpulkan.
DUMMYUNIONNAME.VersionDetail.MinorVersion
Nomor versi minor dari sistem operasi tempat jejak dikumpulkan.
DUMMYUNIONNAME.VersionDetail.SubVersion
Dicadangkan.
DUMMYUNIONNAME.VersionDetail.SubMinorVersion
Dicadangkan.
ProviderVersion
Nomor build sistem operasi tempat jejak dikumpulkan.
NumberOfProcessors
Jumlah prosesor pada sistem tempat jejak dikumpulkan.
EndTime
Waktu di mana sesi pelacakan peristiwa berhenti, dalam interval 100 nanodetik sejak tengah malam, 1 Januari 1601. Nilai ini mungkin 0 jika Anda menggunakan peristiwa secara real time atau dari file log yang tidak diselesaikan (yaitu tidak ditutup dengan benar).
TimerResolution
Resolusi timer perangkat keras, dalam unit 100 nanodetik. Untuk penggunaan, lihat Keterangan untuk EVENT_TRACE_HEADER.
MaximumFileSize
Ukuran maksimum file log, dalam megabyte.
LogFileMode
Mode pengelogan untuk sesi pelacakan peristiwa. Untuk daftar nilai, lihat Konstanta Mode Pengelogan.
BuffersWritten
Jumlah total buffer yang ditulis oleh sesi pelacakan peristiwa.
DUMMYUNIONNAME2
DUMMYUNIONNAME2.LogInstanceGuid
Dicadangkan.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.StartBuffers
Dicadangkan.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.PointerSize
Ukuran default jenis data pointer, dalam byte.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.EventsLost
Jumlah peristiwa yang hilang selama sesi pelacakan peristiwa. Peristiwa terutama hilang karena memori yang tidak mencukupi yang dialokasikan untuk sesi pencatatan jejak atau tingkat peristiwa masuk yang sangat tinggi.
DUMMYUNIONNAME2.DUMMYSTRUCTNAME.CpuSpeedInMHz
Kecepatan CPU, dalam megahertz, dari sistem tempat jejak dikumpulkan.
Windows 2000: Anggota ini tidak didukung.
LoggerName
Jangan gunakan bidang ini.
Nama sesi pelacakan peristiwa adalah string pertama yang dihentikan null mengikuti struktur ini dalam memori.
LogFileName
Jangan gunakan bidang ini.
Nama file log pelacakan peristiwa adalah string kedua yang dihentikan null mengikuti struktur ini dalam memori. String pertama adalah nama sesi.
TimeZone
Struktur TIME_ZONE_INFORMATION yang berisi zona waktu untuk anggota BootTime, EndTime , dan StartTime .
BootTime
Waktu di mana sistem dimulai, dalam interval 100 nanodetik sejak tengah malam, 1 Januari 1601. BootTime hanya didukung untuk jejak yang ditulis ke sesi Global Logger.
PerfFreq
Frekuensi penghitung kinerja resolusi tinggi, jika ada.
StartTime
Waktu di mana sesi pelacakan peristiwa dimulai, dalam interval 100 nanodetik sejak tengah malam, 1 Januari 1601.
ReservedFlags
Menentukan jenis jam. Untuk detailnya, lihat anggota ClientContextdari WNODE_HEADER.
BuffersLost
Jumlah total buffer yang hilang selama sesi pelacakan peristiwa.
Keterangan
Pastikan untuk menginisialisasi memori untuk struktur ini ke nol sebelum mengatur anggota mana pun.
Peristiwa pertama dari file log apa pun berisi data yang ditentukan dalam struktur ini. Anda dapat menggunakan struktur ini untuk mengakses data peristiwa atau Anda dapat menggunakan kelas MOF EventTrace_Header untuk mendekode data peristiwa. Menggunakan struktur ini untuk membaca data peristiwa dapat mengembalikan hasil yang tidak terduga jika konsumen berada di komputer yang berbeda dari yang menghasilkan file log atau file log ditulis dalam sesi WOW (32-bit) pada komputer 64-bit. Ini karena anggota LoggerName dan LogFileName adalah penunjuk dan dapat bervariasi dalam ukuran tergantung pada anggota PointerSize .
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | evntrace.h |