Поделиться через

EventNameFilters

  • Статья

Элемент EventNameFilters включает или исключает события трассировки на основе их имен.

Примечание

Доступно в Windows 10 версии 1709 и более поздних.

Иерархия элементов

Синтаксис

<EventNameFilters FilterIn="true|false" Level="unsigned byte" Operation ="Set|Add|Remove" >

  <!-- Child elements -->
  <Keyword>
  <EventName>

</EventNameFilters>

Атрибуты и элементы

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
FilterIn Указывает, следует ли включать или исключать указанные события stackwalk. Логическое Да
Уровень уровень события Байт без знака Нет
Операция Указывает, следует ли задавать или добавлять ключевые слова. Этот атрибут может иметь одно из следующих значений:
  • Присвойте параметру
  • Добавить
  • Удалить
 Нет Присвойте параметру

Дочерние элементы

Элемент Описание Требование
EventName Имя события tracelogging. Обязательный, 1 или более.
Ключевое слово Ключевое слово событий Необязательно

Родительские элементы

Элемент Описание
EventProvider Представляет поставщика событий для профиля.

Комментарий

Элемент EventNameFilters включает фильтрацию событий по EVENT_FILTER_DESCRIPTOR, Type EVENT_FILTER_TYPE_EVENT_NAME.

Несмотря на то, что трассировка событий Windows поддерживает эффективную фильтрацию полезных данных и атрибутов, события должны в первую очередь фильтроваться область фильтрами или с помощью уровней и ключевое слово для снижения затрат на ЦП.

Пример

    <EventProvider Id="EventProvider_TraceLogGen" Name="3970F9cf-2c0c-4f11-b1cc-e3a1e9958833">
      <EventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </EventNameFilters>
    </EventProvider>

Elements (XElement Dynamic Property) (Elements (Динамическое свойство XElement))