SystemProvider 中的 CaptureStateOnDemand

表示关键字的集合，这些关键字在录制时按需触发这些关键字的内核运行。 可以通过 命令触发提供程序 wpr -capturestateondemand 的 capturestate。 如果指定了“操作”属性，则可以设置 Keyword 元素或将其添加到集合中。

元素层次结构

• < WindowsPerformanceRecorder>
  • < Profiles>
    • < SystemProvider>
      • < CaptureStateOnDemand>
    • < Profile>
      • < Collectors>
        • < SystemCollectorId>
          • < SystemProviderId>
            • < CaptureStateOnDemand>
          • < SystemProvider>
            • < CaptureStateOnDemand>

语法

<CaptureStateOnDemand Operation = "Set" | "Add"> | “Remove”
  <!-- Child elements -->
  Keyword (System),
  CustomKeyword
</CaptureStateOnDemand>

特性和元素

特性

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

子元素

元素	说明	要求
Keyword (in SystemProvider)	描述 SystemLogger 会话的内核标志。	必需（一个或多个）。

备注

WPR 会在跟踪结束时自动执行系统关键字的运行。 如果，请使用 CaptureState* 元素

• 你希望当前未启用的系统关键字的破败
• 你知道由于系统关闭，跟踪结束时不会发生崩溃
• 你想要在特定时间启动运行。

如果启用内核关键字 (keyword) （例如在跟踪开始时）或Stop禁用关键字 (keyword) ，请将 RundownFlag Start 设置为 。

父元素

元素	说明
SystemProvider	表示配置文件的系统提供程序。
SystemProviderId	表示系统提供程序标识符。

示例

以下代码示例演示如何使用此元素。

    <SystemProvider Id="SystemProvider_CaptureStateOnDemand">
        <Keywords>
            <Keyword Value="MemoryInfo" />
        </Keywords>
        <CaptureStateOnDemand>
            <Keyword Value="Pool" RundownFlag="Stop"/>
        </CaptureStateOnDemand>
    </SystemProvider>
</SystemProvider>

相关主题

元素

CustomKeyword

SystemProvider 中的 CaptureStateOnStart

SystemProvider 中的 CaptureStateOnSave