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，请使用 in 类型作为输出格式。 有关这些类型的说明，请参阅 InputType 中的备注。

有关这些类型的说明，请参阅 事件跟踪 MOF 限定符。

nonStructType.MapNameOffset

从 TRACE_EVENT_INFO 结构的开头偏移到包含映射属性值名称的以 null 结尾的 Unicode 字符串。 可以将此字符串传递给 TdhGetEventMapInformation 以检索有关值映射的信息。

structType

如果设置了 Flags 中的 PropertyStruct 标志，请使用这些成员;否则，请使用 nonStructType 成员。

structType.StructStartIndex

包含结构第一个成员的属性数组的元素的从零开始的索引。

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

包含数组中元素数的属性数组的元素的从零开始的索引。 如果已设置 Flags 中的 PropertyParamCount 标志，请使用此成员;否则，请使用 count 成员。

length

属性的大小（以字节为单位）。 请注意，字符串和二进制数据等可变大小的类型长度为零，除非 属性具有 length 属性来显式指示其实际长度。 结构的长度为零。

lengthPropertyIndex

包含此属性的大小值的属性数组的元素的从零开始的索引。 如果已设置 Flags 中的 PropertyParamLength 标志，请使用此成员;否则，请使用 length 成员。

Reserved

保留。

Tags

与字段元数据关联的 28 位值。 仅当设置了 PropertyHasTags 标志时，此值才有效。 事件提供程序可以使用此值将其他语义数据与字段相关联，供事件处理工具使用。 例如，标记值 1 可能指示字段包含用户名。 此字段中任何值的语义都由事件提供程序定义。

注解

筛选器不支持映射、结构或数组。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 tdh.h

另请参阅

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO