EVENT_RECORD 結構 (evntcons.h)
定義 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) |