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

CaptureStateOnDemand в EventProvider

  • Статья

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

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

Синтаксис

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

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

Атрибуты

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

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

Элемент Описание Требование
Ключевое слово (в 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>
  <CaptureStateOnDemand>
    <Keyword Value="0xff4"/> <!-- Provider is  enabled with these keywords when user initiates wpr -capturestateondemand command. -->
  </CaptureStateOnDemand>
</EventProvider>

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

Ключевое слово (в SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave