次の方法で共有

EVENT_HEADER_EXTENDED_DATA_ITEM構造体 (evntcons.h)

  • [アーティクル]

Event Tracing for 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 メンバーは、イベントを書き込む traceEventInstance を呼び出した場合 アクティビティ識別子を含む EVENT_EXTENDED_ITEM_INSTANCE 構造体を指します。
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS
 DataPtr メンバーは、現在の PMC カウンター値を含む EVENT_EXTENDED_ITEM_PMC_COUNTERS 構造体を指します。 この機能を有効にするには、CPU の有効な PMC カウンター TraceSetInformationを使用して、TraceProfileSourceListInfoを使用して TraceQueryInformation 呼び出すことによって検出された有効な ソース 値 設定する必要があります。
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
 DataPtr メンバーは、イベントを書き込む eventWriteTransfer 呼び出した場合、関連するアクティビティ識別子を含む 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
 DataPtr メンバーは、イベントが 64 ビット コンピューターでキャプチャされた場合に呼び出し履歴を含む EVENT_EXTENDED_ITEM_STACK_TRACE64 構造体を指します。
EVENT_HEADER_EXT_TYPE_TS_ID
 DataPtr メンバーは、ターミナル セッション識別子を含む EVENT_EXTENDED_ITEM_TS_ID 構造体を指します。 ENABLETraceEx の EnableProperty パラメーターを EVENT_ENABLE_PROPERTY_TS_ID に設定した場合、ETW にはターミナル セッション識別子 含まれます。

Linkage

引っ込み思案。

Reserved2

引っ込み思案。

DataSize

DataPtr が指 拡張データのサイズ (バイト単位)。

DataPtr

拡張データへのポインター。 ExtType メンバーは、このメンバーが指す拡張データの種類を決定します。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー evntcons.h (Evntcons.h を含む)

関連項目

EVENT_RECORD