EVENT_PROPERTY_INFO 結構 (tdh.h)

  • 發行項

提供事件或篩選之單一屬性的相關信息。

語法

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，請使用 類型中的 作為輸出格式。 如需這些類型的描述，請參閱 InputType 中的。

如需這些類型的描述，請參閱 事件追蹤MOF限定符。

nonStructType.MapNameOffset

從 TRACE_EVENT_INFO 結構的開頭位移到包含 map 屬性值名稱的 Null 終止 Unicode 字串。 您可以將此字串傳遞至 TdhGetEventMapInformation ，以擷取值對應的相關信息。

structType

如果已設定 Flags 中的 PropertyStruct 旗標，請使用這些成員;否則，請使用 nonStructType 成員。

structType.StructStartIndex

屬性陣列的以零起始的索引，其中包含 結構的第一個成員。

structType.NumOfStructMembers

結構中的成員數目。

structType.padding

未使用。

customSchemaType

如果已設定 Flags 中的 PropertyHasCustomSchema 旗標，請使用這些成員;否則，請使用 nonStructType 成員。

customSchemaType.InType

customSchemaType.OutType

此屬性的輸出格式。 如果值為 TDH_OUTTYPE_NULL，請使用 類型中的 作為輸出格式。 如需這些類型的描述，請參閱 InputType 中的。

如需這些類型的描述，請參閱 事件追蹤MOF限定符。

customSchemaType.CustomSchemaOffset

將位元組 (位移) 從TRACE_EVENT_INFO結構的開頭移至自定義架構資訊。 自定義架構資訊將包含 2 位元組通訊協定識別碼，後面接著 2 位元組架構長度，後面接著架構。

count

陣列中的項目數目。 請注意，對於未定義為陣列的屬性，這個值是1。

countPropertyIndex

屬性陣列的元素以零起始的索引，其中包含陣列中的項目數目。 如果已設定 Flags 中的 PropertyParamCount 旗標，請使用這個成員;否則，請使用 count 成員。

length

屬性的大小，以位元組為單位。 請注意，字串和二進位數據等可變大小型別的長度為零，除非屬性具有 length 屬性，才能明確指出其實際長度。 結構長度為零。

lengthPropertyIndex

屬性陣列的以零起始的索引，其中包含此屬性的大小值。 如果已設定 Flags 中的 PropertyParamLength 旗標，請使用這個成員;否則，請使用長度成員。

Reserved

保留的。

Tags

與欄位元數據相關聯的28位值。 只有在已設定 PropertyHasTags 旗標時，這個值才有效。 事件提供者可以使用此值，將其他語意數據與字段產生關聯，以供事件處理工具使用。 例如，標籤值為 1 可能表示欄位包含使用者名稱。 此欄位中任何值的語意是由事件提供者所定義。

備註

篩選不支持對應、結構或陣列。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
標頭 tdh.h

另請參閱

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO