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 |