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

CaptureStateOnStart в EventProvider

  • Статья

Представляет коллекцию ключевых слов, описывающих события, которые необходимо записать в начале записи. Библиотека запрашивает у поставщика сведения о своем состоянии, когда поставщик включен. Если указан атрибут Operation , элементы Keyword можно задать или добавить в коллекцию.

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

Синтаксис

<CaptureStateOnStart Operation = "Set" | "Add"> | “Remove”

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

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

Атрибуты

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

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

Элемент Описание Требование
Ключевое слово (в EventProvider) Описание ключевое слово трассировки событий Windows (ETW) для поставщика пользовательского режима. Обязательный, один или несколько.

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

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

Пример

В следующем примере кода показано, как используется этот элемент.

<EventProvider Id="sample-provider" Name="SampleProvider" NonPagedMemory="true" Level="5">
  <Keywords>
    <Keyword Value="0x98"/> <!-- Provider is enabled with these keywords throughout tracing session -->
  </Keywords>
  <CaptureStateOnStart>
    <Keyword Value="0xff4"/> <!-- Provider is  enabled with these keywords when tracing is started. -->
  </CaptureStateOnStart>
  <CaptureStateOnSave>
    <Keyword Value="0x118"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

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

CustomKeyword

CaptureStateOnSave