EventProvider 中的 CaptureStateOnDemand

表示一组关键字，这些关键字描述在录制时要按需捕获的事件。 库请求提供程序在启用提供程序时记录其状态信息。 可以通过 命令触发提供程序 wpr -capturestateondemand 的 capturestate。 如果指定了“操作”属性，则可以设置 Keyword 元素或将其添加到集合中。

元素层次结构

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

语法

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

特性和元素

特性

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

子元素

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

相关主题

元素

Keyword (in SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave