Freigeben über

CaptureStateOnStart in EventProvider

  • Artikel

Stellt eine Sammlung von Schlüsselwörtern dar, die Ereignisse beschreiben, die am Anfang einer Aufzeichnung erfasst werden sollen. Die Bibliothek fordert den Anbieter auf, seine Zustandsinformationen zu protokollieren, wenn der Anbieter aktiviert wird. Wenn das Attribut Operation angegeben ist, können die Keyword-Elemente festgelegt oder der Sammlung hinzugefügt werden.

Elementhierarchie

Syntax

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

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

Elemente

CustomKeyword

CaptureStateOnSave