struktur EVENT_RECORD (evntcons.h)

Artikel
02/29/2024

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)