структура 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, которая содержит имя свойства. Если это свойство события, смещение начинается с начала структуры TRACE_EVENT_INFO . Если это свойство фильтра, смещение начинается с начала структуры PROVIDER_FILTER_INFO .
nonStructType
Используйте эти элементы, если флаг PropertyStruct в flags не задан; В противном случае используйте элемент structType .
nonStructType.InType
Тип данных этого свойства для входных данных. Описание этих типов см. в разделе Примечания в InputType.
Описание этих типов см. в разделе Квалификаторы MOF трассировки событий.
TdhGetPropertySizeTdhGetPropertySize
nonStructType.OutType
Формат выходных данных для этого свойства. Если значение равно TDH_OUTTYPE_NULL, используйте в качестве выходного формата в типе . Описание этих типов см. в разделе Примечания в InputType.
Описание этих типов см. в разделе Квалификаторы MOF трассировки событий.
nonStructType.MapNameOffset
Смещение от начала структуры TRACE_EVENT_INFO до строки Юникода, завершаемой null, которая содержит имя значения атрибута карты. Эту строку можно передать в TdhGetEventMapInformation , чтобы получить сведения о сопоставлении значений.
structType
Используйте эти элементы, если установлен флаг PropertyStruct в flags ; В противном случае используйте элемент nonStructType .
structType.StructStartIndex
Отсчитываемый от нуля индекс для элемента массива свойств, содержащего первый элемент структуры.
structType.NumOfStructMembers
Число элементов в структуре.
structType.padding
Не используется.
customSchemaType
Используйте эти элементы, если установлен флаг PropertyHasCustomSchema в flags ; В противном случае используйте элемент nonStructType .
customSchemaType.InType
customSchemaType.OutType
Формат выходных данных для этого свойства. Если значение равно TDH_OUTTYPE_NULL, используйте в качестве выходного формата в типе . Описание этих типов см. в разделе Примечания в InputType.
Описание этих типов см. в разделе Квалификаторы MOF трассировки событий.
customSchemaType.CustomSchemaOffset
Смещение (в байтах) от начала структуры TRACE_EVENT_INFO до сведений о пользовательской схеме. Сведения о пользовательской схеме будут содержать 2-байтный идентификатор протокола, за которым следует 2-байтовая длина схемы, а затем схема.
count
Количество элементов в массиве. Обратите внимание, что это значение равно 1 для свойств, которые не определены как массив.
countPropertyIndex
Отсчитываемый от нуля индекс элемента массива свойств, который содержит количество элементов в массиве. Используйте этот член, если установлен флаг PropertyParamCount в разделе Флаги ; В противном случае используйте элемент count .
length
Размер свойства в байтах. Обратите внимание, что типы переменных размеров, такие как строки и двоичные данные, имеют нулевую длину, если свойство не имеет атрибут length для явного указания его реальной длины. Длина структур равна нулю.
lengthPropertyIndex
Отсчитываемый от нуля индекс элемента массива свойств, который содержит значение размера этого свойства. Используйте этот член, если установлен флаг PropertyParamLength в flags ; В противном случае используйте элемент length .
Reserved
Зарезервировано.
Tags
28-разрядное значение, связанное с метаданными поля. Это значение допустимо, только если установлен флаг PropertyHasTags . Это значение может использоваться поставщиком событий для связывания дополнительных семантических данных с полем для использования средством обработки событий. Например, значение тега 1 может указывать на то, что поле содержит имя пользователя. Семантика любых значений в этом поле определяется поставщиком событий.
Комментарии
Фильтры не поддерживают карты, структуры или массивы.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
Верхняя часть | tdh.h |