CaptureStateOnDemand in EventProvider

Stellt eine Auflistung von Schlüsselwörtern dar, die Ereignisse beschreiben, die bei Bedarf während der Aufzeichnung erfasst werden sollen. Die Bibliothek fordert den Anbieter auf, seine Zustandsinformationen zu protokollieren, wenn der Anbieter aktiviert wird. Sie können den Capturestate des Anbieters über wpr -capturestateondemand den Befehl auslösen. Wenn das Operation-Attribut angegeben ist, können die Keyword-Elemente festgelegt oder der Sammlung hinzugefügt werden.

Elementhierarchie

• < WindowsPerformanceRecorder>
  • < Profile>
    • < EventProvider>
      • < CaptureStateOnDemand>
    • < Profil>
      • < Sammler>
        • < EventCollectorId>
          • < EventProviderId>
            • < CaptureStateOnDemand>
          • < EventProvider>
            • < CaptureStateOnDemand>

Syntax

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

Attribute und Elemente

Attribute

attribute	BESCHREIBUNG	Datentyp	Erforderlich	Standard
Vorgang	Gibt an, ob Schlüsselwörter festgelegt oder hinzugefügt werden sollen.	Dieses Attribut kann einen der folgenden Werte annehmen: Set Hinzufügen Remove (Entfernen)	Nein	Set

Untergeordnete Elemente

Element	BESCHREIBUNG	Anforderung
Keyword (in EventProvider)	Beschreibt das Schlüsselwort Event Tracing for Windows (ETW) für einen Benutzermodusanbieter.	Erforderlich, eine oder mehrere.

Übergeordnete Elemente

Element	Beschreibung
EventProvider	Stellt einen Ereignisanbieter für das Profil dar.
EventProviderId	Stellt einen Ereignisanbieterbezeichner dar.

Beispiel

Das folgende Codebeispiel zeigt, wie dieses Element verwendet wird.

<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>

Zugehörige Themen

Elemente

Keyword (in SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave