struktur EVENT_RECORD (evntcons.h)
Menentukan tata letak peristiwa yang dikirimkan Event Tracing for Windows (ETW).
Sintaks
typedef struct _EVENT_RECORD {
EVENT_HEADER EventHeader;
ETW_BUFFER_CONTEXT BufferContext;
USHORT ExtendedDataCount;
USHORT UserDataLength;
PEVENT_HEADER_EXTENDED_DATA_ITEM ExtendedData;
PVOID UserData;
PVOID UserContext;
} EVENT_RECORD, *PEVENT_RECORD;
Anggota
EventHeader
Informasi tentang peristiwa seperti stempel waktu saat ditulis. Untuk detailnya, lihat struktur EVENT_HEADER .
BufferContext
Menentukan informasi seperti sesi yang mencatat peristiwa. Untuk detailnya, lihat struktur ETW_BUFFER_CONTEXT .
ExtendedDataCount
Jumlah struktur data yang diperluas di anggota ExtendedData .
UserDataLength
Ukuran, dalam byte, data di anggota UserData .
ExtendedData
Satu atau beberapa item data yang diperluas yang dikumpulkan ETW. Data yang diperluas mencakup beberapa item, seperti pengidentifikasi keamanan (SID) pengguna yang mencatat peristiwa, hanya jika pengontrol mengatur parameter EnableProperty yang diteruskan ke fungsi EnableTraceEx atau EnableTraceEx2 . Data yang diperluas mencakup item lain, seperti pengidentifikasi aktivitas terkait dan informasi pendekodean untuk pencatatan jejak, terlepas dari apakah pengontrol mengatur parameter EnableProperty yang diteruskan ke EnableTraceEx atau EnableTraceEx2. Untuk detailnya, lihat struktur EVENT_HEADER_EXTENDED_DATA_ITEM .
UserData
Data khusus peristiwa. Untuk mengurai data ini, lihat Mengambil Data Peristiwa Menggunakan TDH. Jika anggota BenderaEVENT_HEADER berisi EVENT_HEADER_FLAG_STRING_ONLY, data adalah string Unicode null-dihentikan yang tidak perlu diurai TDH.
UserContext
Konteks th yang ditentukan dalam anggota Konteks struktur EVENT_TRACE_LOGFILE yang diteruskan ke fungsi OpenTrace .
Keterangan
Struktur EVENT_RECORD diteruskan ke implementasi konsumen dari panggilan balik EventRecordCallback .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Header | evntcons.h (termasuk Evntcons.h) |