EventProvider 中的 CaptureStateOnSave

表示关键字集合，这些关键字描述在保存跟踪时要捕获的事件。 库请求提供程序在保存收集器时记录其状态信息。 如果指定了“操作”属性，则可以设置 Keyword 元素或将其添加到集合中。

元素层次结构

• < WindowsPerformanceRecorder>
  • < Profiles>
    • < EventProvider>
      • < CaptureStateOnSave>
    • < Profile>
      • < Collectors>
        • < EventCollectorId>
          • < EventProviderId>
            • < CaptureStateOnSave>
          • < EventProvider>
            • < CaptureStateOnSave>

语法

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnSave>

特性和元素

特性

属性	说明	数据类型	必须	默认
操作	指示是应设置还是添加关键字。	此属性可以具有以下值之一： 设置 添加 删除	否	设置

子元素

元素	说明	要求
Keyword (in 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>

相关主题

元素

CustomKeyword

CaptureStateOnStart

EventProvider) 中的 CaptureStateOnDemand (