EVENT_RECORD 結構 (evntcons.h)

發行項
02/29/2024

定義 Windows 事件追蹤 (ETW) 傳遞的事件配置。

語法

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;

成員

EventHeader

事件的相關信息，例如寫入事件時的時間戳。如需詳細資訊，請參閱 EVENT_HEADER 結構。

BufferContext

定義記錄事件的會話等資訊。如需詳細資訊，請參閱 ETW_BUFFER_CONTEXT 結構。

ExtendedDataCount

ExtendedData 成員中的擴充數據結構數目。

UserDataLength

UserData 成員中數據的大小，以位元組為單位。

ExtendedData

ETW 所收集的一或多個擴充數據項。擴充數據包含某些專案，例如記錄事件之使用者的安全性標識碼 (SID) ，只有在控制器設定傳遞至 EnableTraceEx 或 EnableTraceEx2 函式的 EnableProperty 參數時。擴充數據包含其他專案，例如追蹤記錄的相關活動標識符和譯碼資訊，不論控制器是否設定傳遞至 EnableTraceEx 或 EnableTraceEx2 的 EnableProperty 參數。如需詳細資訊，請參閱 EVENT_HEADER_EXTENDED_DATA_ITEM 結構。

UserData

事件特定數據。若要剖析此數據，請參閱使用 TDH 擷取事件數據。如果EVENT_HEADER的 Flags 成員包含EVENT_HEADER_FLAG_STRING_ONLY，則數據會是 Null 終止的 Unicode 字串，您不需要 TDH 進行剖析。

UserContext

在傳遞至 OpenTrace 函式之 EVENT_TRACE_LOGFILE 結構的內容成員中指定的內容。

備註

EVENT_RECORD 結構會傳遞至取用者的 EventRecordCallback 回呼實作。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	evntcons.h (包括 Evntcons.h)