TRACE_EVENT_INFO 構造体 (tdh.h)
イベントに関する情報を定義します。
構文
typedef struct _TRACE_EVENT_INFO {
GUID ProviderGuid;
GUID EventGuid;
EVENT_DESCRIPTOR EventDescriptor;
DECODING_SOURCE DecodingSource;
ULONG ProviderNameOffset;
ULONG LevelNameOffset;
ULONG ChannelNameOffset;
ULONG KeywordsNameOffset;
ULONG TaskNameOffset;
ULONG OpcodeNameOffset;
ULONG EventMessageOffset;
ULONG ProviderMessageOffset;
ULONG BinaryXMLOffset;
ULONG BinaryXMLSize;
union {
ULONG EventNameOffset;
ULONG ActivityIDNameOffset;
};
union {
ULONG EventAttributesOffset;
ULONG RelatedActivityIDNameOffset;
};
ULONG PropertyCount;
ULONG TopLevelPropertyCount;
union {
TEMPLATE_FLAGS Flags;
struct {
ULONG Reserved : 4;
ULONG Tags : 28;
};
};
EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;
メンバー
ProviderGuid
プロバイダーを識別する GUID。
EventGuid
イベントを含む MOF クラスを識別する GUID。 プロバイダーがマニフェストを使用してそのイベントを定義する場合、このメンバーはGUID_NULL。
EventDescriptor
イベント を 記述するEVENT_DESCRIPTOR構造体。
DecodingSource
イベント の データの解析に使用されるソースを識別するDECODING_SOURCE列挙値 (WMI MOF クラスのインストルメンテーション マニフェストなど)。
ProviderNameOffset
この構造体の先頭から、プロバイダーの名前を含む null で終わる Unicode 文字列までのオフセット。
LevelNameOffset
この構造体の先頭から、レベルの名前を含む null で終わる Unicode 文字列までのオフセット。 使用できる名前については、「 LevelType の解説」を参照してください。
ChannelNameOffset
この構造体の先頭から、チャネルの名前を含む null で終わる Unicode 文字列までのオフセット。 使用できる名前については、「 ChannelType の解説」を参照してください。
KeywordsNameOffset
この構造体の先頭から、キーワードの名前を含む null で終わる Unicode 文字列のリストへのオフセット。 リストは 2 つの NULL 文字で終了します。 使用できる名前については、「 KeywordType の解説」を参照してください。
TaskNameOffset
この構造体の先頭から、タスクの名前を含む null で終わる Unicode 文字列までのオフセット。 使用できる名前については、「 TaskType の解説」を参照してください。
OpcodeNameOffset
この構造体の先頭から、操作の名前を含む null で終わる Unicode 文字列までのオフセット。 使用できる名前については、「 OpcodeType の解説」を参照してください。
EventMessageOffset
この構造体の先頭から、イベント メッセージ文字列を含む null で終わる Unicode 文字列までのオフセット。 メッセージ文字列がない場合、オフセットは 0 になります。 メッセージ文字列の詳細については、EventDefinitionType の message 属性を参照してください。
メッセージ文字列には、挿入シーケンス (たとえば、%1 プリンターに接続できません) を含めることができます。 挿入シーケンスの番号は、置換に使用するイベント データのプロパティを識別します。
ProviderMessageOffset
この構造体の先頭から、ローカライズされたプロバイダー名を含む null で終わる Unicode 文字列までのオフセット。
BinaryXMLOffset
予約済み。
BinaryXMLSize
予約済み。
EventNameOffset
ActivityIDNameOffset
この構造体の先頭から、MOF クラスのアクティビティ識別子のプロパティ名を含む null で終わる Unicode 文字列までのオフセット。 従来の ETW イベントでのみサポートされます。
EventAttributesOffset
RelatedActivityIDNameOffset
この構造体の先頭から、MOF クラスの関連アクティビティ識別子のプロパティ名を含む null で終わる Unicode 文字列までのオフセット。 レガシ ETW イベントでのみサポートされます。
PropertyCount
EventPropertyInfoArray 配列内の要素の数。
TopLevelPropertyCount
最上位のプロパティである EventPropertyInfoArray 配列内のプロパティの数。 この数値には構造体のメンバーは含まれません。 最上位のプロパティは、配列内のすべてのメンバー プロパティの前にあります。
Flags
予約済み。
Reserved
Tags
イベント メタデータに関連付けられた 28 ビット値。 この値は、イベント プロバイダーがイベント処理ツールで使用するイベントに追加のセマンティック データを関連付けるために使用できます。 たとえば、タグ値 5 は、イベントにデバッグ情報が含まれていることを示している場合があります。 このフィールド内の値のセマンティクスは、イベント プロバイダーによって定義されます。
EventPropertyInfoArray[ANYSIZE_ARRAY]
イベント のユーザー データの各プロパティに関する情報を提供するEVENT_PROPERTY_INFO構造体の配列。
注釈
メンバーが定義されていない場合、オフセットの値は 0 です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | tdh.h |