共用方式為


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 或 EnableTraceEx2EnableProperty 參數。 如需詳細資訊,請參閱 EVENT_HEADER_EXTENDED_DATA_ITEM 結構。

UserData

事件特定數據。 若要剖析此數據,請參閱 使用 TDH 擷取事件數據。 如果EVENT_HEADERFlags 成員包含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)

另請參閱

ETW_BUFFER_CONTEXT

EVENT_HEADER

EVENT_HEADER_EXTENDED_DATA_ITEM

EVENT_TRACE_LOGFILE

EnableTraceEx

EnableTraceEx2

EventRecordCallback

OpenTrace