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


CaptureStateOnSave в EventProvider

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

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

Синтаксис

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnSave>

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

Атрибуты

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

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

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

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

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

Пример

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

<EventProvider Id="EventProvider_DWMWin32k_CaptureState" Name="e7ef96be-969f-414f-97d7-3ddb7b558ccc" NonPagedMemory="true" CaptureStateOnly="true" > 
  <!-- CaptureStateOnly="true" means provider is not enabled throughout the tracing session. -->
  <CaptureStateOnSave>
    <Keyword Value="0x80000"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

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

CustomKeyword

CaptureStateOnStart

CaptureStateOnDemand(in EventProvider)