структура TRACE_EVENT_INFO (tdh.h)

Статья
03/13/2024

Определяет сведения о событии.

Синтаксис

typedef struct _TRACE_EVENT_INFO {
  GUID                ProviderGuid;
  GUID                EventGuid;
  EVENT_DESCRIPTOR    EventDescriptor;
  DECODING_SOURCE     DecodingSource;
  ULONG               ProviderNameOffset;
  ULONG               LevelNameOffset;
  ULONG               ChannelNameOffset;
  ULONG               KeywordsNameOffset;
  ULONG               TaskNameOffset;
  ULONG               OpcodeNameOffset;
  ULONG               EventMessageOffset;
  ULONG               ProviderMessageOffset;
  ULONG               BinaryXMLOffset;
  ULONG               BinaryXMLSize;
  union {
    ULONG EventNameOffset;
    ULONG ActivityIDNameOffset;
  };
  union {
    ULONG EventAttributesOffset;
    ULONG RelatedActivityIDNameOffset;
  };
  ULONG               PropertyCount;
  ULONG               TopLevelPropertyCount;
  union {
    TEMPLATE_FLAGS Flags;
    struct {
      ULONG Reserved : 4;
      ULONG Tags : 28;
    };
  };
  EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;

Члены

ProviderGuid

Идентификатор GUID, идентифицирующий поставщика.

EventGuid

GUID, идентифицирующий класс MOF, содержащий событие. Если поставщик использует манифест для определения событий, этот элемент GUID_NULL.

EventDescriptor

Структура EVENT_DESCRIPTOR , описывающая событие.

DecodingSource

Значение перечисления DECODING_SOURCE , определяющее источник, используемый для анализа данных события (например, манифест инструментирования класса WMI MOF).

ProviderNameOffset

Смещение от начала этой структуры до строки Юникода, заканчивающейся нулевым значением, которая содержит имя поставщика.

LevelNameOffset

Смещение от начала этой структуры до строки Юникода, заканчивающейся нулевым значением, которая содержит имя уровня. Возможные имена см. в разделе Примечания в LevelType.

ChannelNameOffset

Смещение от начала этой структуры до строки Юникода, заканчивающейся нулевым значением, которая содержит имя канала. Возможные имена см. в разделе Примечания в ChannelType.

KeywordsNameOffset

Смещение от начала этой структуры до списка строк Юникода, завершаемых nullом, которые содержат имена ключевых слов. Список завершается двумя символами NULL. Возможные имена см. в разделе Примечания в KeywordType.

TaskNameOffset

Смещение от начала этой структуры до строки Юникода, завершаемой null, которая содержит имя задачи. Возможные имена см. в разделе Примечания в TaskType.

OpcodeNameOffset

Смещение от начала этой структуры до строки Юникода, завершаемой null, которая содержит имя операции. Возможные имена см. в разделе Примечания в OpcodeType.

EventMessageOffset

Смещение от начала этой структуры до строки Юникода, завершаемой null, которая содержит строку сообщения о событии. Смещение равно нулю, если нет строки сообщения. Дополнительные сведения о строках сообщений см. в атрибуте message для EventDefinitionType.

Строка сообщения может содержать последовательности вставки, например Не удалось подключиться к принтеру %1. Номер последовательности вставки определяет свойство в данных события для подстановки.

ProviderMessageOffset

Смещение от начала этой структуры до строки Юникода, заканчивающейся нулевым значением, которая содержит локализованное имя поставщика.

BinaryXMLOffset

Зарезервировано.

BinaryXMLSize

Зарезервировано.

EventNameOffset

ActivityIDNameOffset

Смещение от начала этой структуры до строки Юникода, завершаемой null, которая содержит имя свойства идентификатора действия в классе MOF. Поддерживается только для классических событий трассировки событий Windows.

EventAttributesOffset

RelatedActivityIDNameOffset

Смещение от начала этой структуры до строки Юникода, завершаемой null, которая содержит имя свойства идентификатора связанного действия в классе MOF. Поддерживается только для событий трассировки событий Windows прежних версий.

PropertyCount

Количество элементов в массиве EventPropertyInfoArray .

TopLevelPropertyCount

Количество свойств в массиве EventPropertyInfoArray , которые являются свойствами верхнего уровня. Это число не включает элементы структур. Свойства верхнего уровня предоставляются перед всеми свойствами элементов в массиве.

Flags

Зарезервировано.

Reserved

Tags

28-разрядное значение, связанное с метаданными события. Это значение может использоваться поставщиком событий для связывания дополнительных семантических данных с событием для использования средством обработки событий. Например, значение тега 5 может указывать на то, что событие содержит отладочную информацию. Семантика любых значений в этом поле определяется поставщиком событий.

EventPropertyInfoArray[ANYSIZE_ARRAY]

Массив структур EVENT_PROPERTY_INFO , который предоставляет сведения о каждом свойстве пользовательских данных события.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	tdh.h