EventProvider 中的 CaptureStateOnDemand

表示關鍵字集合，描述錄製時要隨選擷取的事件。 當啟用提供者時，程式庫會要求提供者記錄其狀態資訊。 您可以透過 wpr -capturestateondemand 命令觸發提供者的擷取。 如果指定 Operation 屬性，則可以將 Keyword 元素設定或新增至集合。

元素階層

• < WindowsPerformanceRecorder>
  • < 配置 檔>
    • < EventProvider>
      • < CaptureStateOnDemand>
    • < 配置 檔>
      • < 收藏家>
        • < EventCollectorId>
          • < EventProviderId>
            • < CaptureStateOnDemand>
          • < EventProvider>
            • < CaptureStateOnDemand>

Syntax

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

屬性和項目

屬性

屬性	描述	資料類型	必要	預設
運算	指出是否應該設定或新增關鍵字。	此屬性可以有下列其中一個值： 集合 加 移除	No	集合

子元素

元素	描述	需求
關鍵字 (在 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>

相關主題

元素

關鍵字 (在 SystemProvider 中)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave