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構造体を指します。 ETW には、EnableTraceEx の EnableProperty パラメーターを EVENT_ENABLE_PROPERTY_TS_ID に設定した場合、ターミナル セッション識別子が含まれます。
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 イベントを書き込む TraceEventInstance を呼び出した場合、DataPtr メンバーはアクティビティ識別子を含むEVENT_EXTENDED_ITEM_INSTANCE構造体を指します。
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_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 [デスクトップ アプリのみ]
Header evntcons.h (Evntcons.h を含む)

関連項目

EVENT_RECORD