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 |