EVENT_PROPERTY_INFO 構造体 (tdh.h)

  • [アーティクル]

イベントまたはフィルターの 1 つのプロパティに関する情報を提供します。

構文

typedef struct _EVENT_PROPERTY_INFO {
  PROPERTY_FLAGS Flags;
  ULONG          NameOffset;
  union {
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  MapNameOffset;
    } nonStructType;
    struct {
      USHORT StructStartIndex;
      USHORT NumOfStructMembers;
      ULONG  padding;
    } structType;
    struct {
      USHORT InType;
      USHORT OutType;
      ULONG  CustomSchemaOffset;
    } customSchemaType;
  };
  union {
    USHORT count;
    USHORT countPropertyIndex;
  };
  union {
    USHORT length;
    USHORT lengthPropertyIndex;
  };
  union {
    ULONG Reserved;
    struct {
      ULONG Tags : 28;
    };
  };
} EVENT_PROPERTY_INFO;

メンバー

Flags

プロパティが構造体または配列に含まれているかどうかを示すフラグ。 使用可能な値については、 PROPERTY_FLAGS 列挙を参照してください。

NameOffset

プロパティの名前を含む null で終わる Unicode 文字列へのオフセット。 このイベント プロパティの場合、オフセットは TRACE_EVENT_INFO 構造体の先頭から取得されます。 これがフィルター プロパティの場合、オフセットは PROVIDER_FILTER_INFO 構造体の先頭から取得されます。

nonStructType

Flags の PropertyStruct フラグが設定されていない場合は、これらのメンバーを使用します。それ以外の場合は、structType メンバーを使用します。

nonStructType.InType

入力時のこのプロパティのデータ型。 これらの型の説明については、「 InputType の備考」を参照してください。

これらの型の説明については、「 イベント トレース MOF 修飾子」を参照してください。

TdhGetPropertySizeTdhGetPropertySize

nonStructType.OutType

このプロパティの出力形式。 値がTDH_OUTTYPE_NULL場合は、出力形式として in 型を使用します。 これらの型の説明については、「 InputType の備考」を参照してください。

これらの型の説明については、「 イベント トレース MOF 修飾子」を参照してください。

nonStructType.MapNameOffset

TRACE_EVENT_INFO構造体の先頭から、マップ属性値の名前を含む null で終わる Unicode 文字列へのオフセット。 この文字列を TdhGetEventMapInformation に渡して、値マップに関する情報を取得できます。

structType

Flags の PropertyStruct フラグが設定されている場合は、これらのメンバーを使用します。それ以外の場合は、nonStructType メンバーを使用します。

structType.StructStartIndex

構造体の最初のメンバーを含むプロパティ配列の要素に対する 0 から始まるインデックス。

structType.NumOfStructMembers

構造体内のメンバーの数。

structType.padding

使用されていません。

customSchemaType

Flags の PropertyHasCustomSchema フラグが設定されている場合は、これらのメンバーを使用します。それ以外の場合は、nonStructType メンバーを使用します。

customSchemaType.InType

customSchemaType.OutType

このプロパティの出力形式。 値がTDH_OUTTYPE_NULL場合は、出力形式として in 型を使用します。 これらの型の説明については、「 InputType の備考」を参照してください。

これらの型の説明については、「 イベント トレース MOF 修飾子」を参照してください。

customSchemaType.CustomSchemaOffset

TRACE_EVENT_INFO構造体の先頭からカスタム スキーマ情報へのオフセット (バイト単位)。 カスタム スキーマ情報には、2 バイトのプロトコル識別子が含まれます。その後に 2 バイトのスキーマ長が続き、その後にスキーマが続きます。

count

配列内の要素の数。 配列として定義されていないプロパティの場合、この値は 1 であることに注意してください。

countPropertyIndex

配列内の要素の数を含むプロパティ配列の要素に対する 0 から始まるインデックス。 Flags の PropertyParamCount フラグが設定されている場合は、このメンバーを使用します。それ以外の場合は、count メンバーを使用します。

length

プロパティのサイズ (バイト単位)。 プロパティに実際の長さを明示的に示す length 属性がない限り、文字列やバイナリ データなどの可変長型の長さは 0 であることに注意してください。 構造体の長さは 0 です。

lengthPropertyIndex

このプロパティのサイズ値を含むプロパティ配列の要素に対する 0 から始まるインデックス。 Flags の PropertyParamLength フラグが設定されている場合は、このメンバーを使用します。それ以外の場合は、長さメンバーを使用します。

Reserved

予約済み。

Tags

フィールド メタデータに関連付けられている 28 ビット値。 この値は、 PropertyHasTags フラグが設定されている場合にのみ有効です。 この値は、イベント プロバイダーがイベント処理ツールで使用するフィールドに追加のセマンティック データを関連付けるために使用できます。 たとえば、タグ値 1 は、フィールドにユーザー名が含まれていることを示している可能性があります。 このフィールドの値のセマンティクスは、イベント プロバイダーによって定義されます。

注釈

フィルターは、マップ、構造体、または配列をサポートしていません。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header tdh.h

こちらもご覧ください

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO