共用方式為

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_EVENT_KEY
 DataPtr 成員指向包含 64 位純量的唯一事件識別碼的EVENT_EXTENDED_ITEM_EVENT_KEY結構。

EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY 必須針對指定提供者啟用此功能的 EnableTrace 呼叫傳入。
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 DataPtr 成員指向包含 TraceLogging 事件元數據資訊的擴充標頭專案。
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 DataPtr 成員會指向包含活動標識碼的 EVENT_EXTENDED_ITEM_INSTANCE 結構，如果您呼叫 TraceEventInstance 來寫入事件。
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS
 DataPtr 成員指向包含目前 PMC 計數器值的 EVENT_EXTENDED_ITEM_PMC_COUNTERS 結構。 若要啟用這項功能，CPU 的有效 PMC 計數器必須透過 TraceSetInformation來設定，並使用呼叫 traceQueryInformation TraceQueryInformation找到的有效 Source 值。
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 DataPtr 成員指向包含唯一進程標識碼的EVENT_EXTENDED_ITEM_PROCESS_START_KEY結構（在開機會話中是唯一的）。 此標識碼是64位純量。

EnableProperty EVENT_ENABLE_PROPERTY_PROCESS_START_KEY 必須針對指定提供者啟用此功能的 EnableTrace 呼叫傳入。
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 DataPtr 成員指向包含提供者特性數據的擴充標頭專案，例如透過 EventSetInformation（EventProviderSetTraits） 設定 或透過 EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA指定的特性。
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_STACK_TRACE32
 DataPtr 成員指向在 32 位電腦上擷取事件時包含呼叫堆疊的 EVENT_EXTENDED_ITEM_STACK_TRACE32 結構。
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 如果64位電腦上擷取事件，DataPtr 成員會指向包含呼叫堆疊的 EVENT_EXTENDED_ITEM_STACK_TRACE64 結構。
EVENT_HEADER_EXT_TYPE_TS_ID
 DataPtr 成員指向包含終端機會話標識碼的 EVENT_EXTENDED_ITEM_TS_ID 結構。 如果您將 enableTrace Ex 的 enableProperty 參數設定為 EVENT_ENABLE_PROPERTY_TS_ID，ETW 會包含終端機會話標識符。

Linkage

保留。

Reserved2

保留。

DataSize

DataPtr 所指向之擴充數據的大小，以位元組為單位。

DataPtr

擴充數據的指標。 ExtType 成員會決定這個成員所指向的擴充數據類型。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 evntcons.h （include Evntcons.h）

另請參閱

EVENT_RECORD