перечисление EVENT_INFO_CLASS (evntprov.h)

  • Статья

Тип перечисления EVENT_INFO_CLASS используется с функцией EventSetInformation для указания операции конфигурации, выполняемой при регистрации поставщика событий ETW.

Синтаксис

typedef enum _EVENT_INFO_CLASS {
  EventProviderBinaryTrackInfo,
  EventProviderSetReserved1,
  EventProviderSetTraits,
  EventProviderUseDescriptorType,
  MaxEventInfo
} EVENT_INFO_CLASS;

Константы

 
EventProviderBinaryTrackInfo
Добавляет двоичные данные отслеживания от этого поставщика в каждый сеанс, который
собирает события от этого поставщика событий. Двоичные данные отслеживания включают
полный путь к двоичному файлу с обратным вызовом, который был указан при
регистрация поставщика событий. Эти сведения полезны, если двоичный файл
содержит mc.exeсгенерированные
декодирование ресурсов, но не зарегистрировано глобально. Средства декодирования могут использовать
путь в трассировке для поиска двоичного файла и извлечения ресурсов декодирования.

Буфер EventInformation не используется с этой операцией конфигурации. The
Среда выполнения трассировки событий Windows автоматически использует полный путь модуля вызывающего объекта (
полный путь к библиотеке DLL или EXE, содержащей функцию обратного вызова, указанную в
вызов EventRegister). Чтобы эта операция была полезна, та же библиотека DLL или EXE
файл должен содержать созданные mc.exeресурсы декодирования.
EventProviderSetReserved1
Не используется.
EventProviderSetTraits
Задает признаки для поставщика, например имя поставщика. Указывает, что трассировка событий Windows
должен распознавать Type поле
EVENT_DATA_DESCRIPTOR используемых структур
с этим поставщиком. Требует, чтобы поставщик инициализировал все поля
EVENT_DATA_DESCRIPTOR структуры, включая Reserved поле. (
Поставщик обычно должен задавать dataDescriptor.Reserved = 0, как это делается с помощью
EventDataDescCreate.)

Обратите внимание, что структура EVENT_DATA_DESCRIPTOR содержит Type поле в
часть структуры, которая ранее была полем Reserved . Чтобы избежать
проблемы совместимости с поставщиками, которые не инициализировали поле "Зарезервировано",
Трассировка событий Windows будет игнорировать Type поле (обрабатывать его как 0), если поставщик не использовал
EventProviderSetTraits или EventProviderUseDescriptorType в вызове
EventSetInformation.

Буфер EventInformation должен содержать
признаки поставщика , используемые для
поставщика.
EventProviderUseDescriptorType
Указывает, должна ли трассировка событий Windows распознавать Type поле
EVENT_DATA_DESCRIPTOR используемых структур
с этим поставщиком. Если TRUEзадано значение , поставщик должен инициализировать все поля
структуры EVENT_DATA_DESCRIPTOR, включая Reserved поле . (
Поставщик обычно должен задавать dataDescriptor.Reserved = 0, как это делается с помощью
EventDataDescCreate.)

Обратите внимание, что структура EVENT_DATA_DESCRIPTOR содержит Type поле в
часть структуры, которая ранее была полем Reserved . Чтобы избежать
проблемы совместимости с поставщиками, которые не инициализировали поле "Зарезервировано",
Трассировка событий Windows будет игнорировать Type поле (обрабатывать его как 0), если поставщик не использовал
EventProviderSetTraits или EventProviderUseDescriptorType в вызове
EventSetInformation.

Буфер EventInformation должен содержать значение BOOLEAN (1 байт, значение).
FALSE или TRUE).
MaxEventInfo
Первый недопустимый код операции. Это значение может измениться в последующих версиях
windows SDK.

Требования

   
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Верхняя часть evntprov.h

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

EventSetInformation

Признаки поставщика