структура 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

См. также раздел

PROVIDER_FILTER_INFO

TRACE_EVENT_INFO