EventProvider 中的 CaptureStateOnStart

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

元素层次结构

• < WindowsPerformanceRecorder>
  • < Profiles>
    • < EventProvider>
      • < CaptureStateOnStart>
    • < Profile>
      • < Collectors>
        • < EventCollectorId>
          • < EventProviderId>
            • < CaptureStartOnStart>
          • < EventProvider>
            • < CaptureStateOnStart>

语法

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

特性和元素

特性

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

子元素

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

相关主题

元素

CustomKeyword

CaptureStateOnSave