共用方式為


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