EVENT_HEADER_EXTENDED_DATA_ITEM 結構 (evntcons.h)

  • 發行項

定義 Windows 事件追蹤 (ETW) 收集為事件資料的一部分的擴充資料。

語法

typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
  USHORT    Reserved1;
  USHORT    ExtType;
  struct {
    USHORT Linkage : 1;
    USHORT Reserved2 : 15;
  };
  USHORT    DataSize;
  ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;

成員

Reserved1

保留的。

ExtType

擴充資料的類型。 以下是可能的值。

值 意義
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 如果您呼叫EventWriteTransfer來寫入事件，DataPtr成員會指向包含相關活動識別碼的EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID結構。
EVENT_HEADER_EXT_TYPE_SID
 DataPtr成員指向SID結構，其中包含記錄事件之使用者的安全性識別碼 (SID) 。 如果您將EnableTraceEx的EnableProperty參數設定為 EVENT_ENABLE_PROPERTY_SID，ETW 會包含 SID。
EVENT_HEADER_EXT_TYPE_TS_ID
 DataPtr成員指向包含終端機會話識別碼的EVENT_EXTENDED_ITEM_TS_ID結構。 如果您將EnableTraceEx的EnableProperty參數設定為 EVENT_ENABLE_PROPERTY_TS_ID，ETW 會包含終端機會話識別碼。
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 如果您呼叫TraceEventInstance來寫入事件，DataPtr成員會指向包含活動識別碼的EVENT_EXTENDED_ITEM_INSTANCE結構。
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 如果事件擷取在 32 位電腦上， DataPtr 成員會指向包含呼叫堆疊的 EVENT_EXTENDED_ITEM_STACK_TRACE32 結構。
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 如果事件擷取在 64 位電腦上， DataPtr 成員會指向包含呼叫堆疊 的EVENT_EXTENDED_ITEM_STACK_TRACE64 結構。
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 DataPtr成員指向包含 TraceLogging 事件中繼資料資訊的擴充標頭專案。
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 DataPtr成員指向包含提供者特性資料的擴充標頭專案，例如透過EventSetInformation (EventProviderSetTraits) 或透過EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA指定的特性。
EVENT_HEADER_EXT_TYPE_EVENT_KEY
 DataPtr成員指向包含 64 位純量的唯一事件識別碼EVENT_EXTENDED_ITEM_EVENT_KEY結構。

必須針對指定提供者的EnableTrace呼叫傳入EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY，才能啟用這項功能。
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 DataPtr成員指向EVENT_EXTENDED_ITEM_PROCESS_START_KEY結構，其中包含在開機會話) 中唯一 (唯一的進程識別碼。 此識別碼是 64 位純量。

必須針對指定提供者的EnableTrace呼叫傳入EnableProperty EVENT_ENABLE_PROPERTY_PROCESS_START_KEY，才能啟用這項功能。

Linkage

保留的。

Reserved2

保留的。

DataSize

DataPtr所指向擴充資料的大小，以位元組為單位。

DataPtr

擴充資料的指標。 ExtType成員會決定這個成員指向的擴充資料類型。

需求

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

另請參閱

EVENT_RECORD