Partager via

CaptureStateOnStart dans EventProvider

  • Article

Représente une collection de mots clés qui décrivent les événements à capturer au début d’un enregistrement. La bibliothèque demande au fournisseur de consigner ses informations d’état lorsque le fournisseur est activé. Si l’attribut Operation est spécifié, les éléments Keyword peuvent être définis ou ajoutés à la collection.

Hiérarchie d’éléments

Syntaxe

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Default
opération Indique si des mots clés doivent être définis ou ajoutés. Cet attribut peut avoir l’une des valeurs suivantes :
  • Définissez
  • Ajouter
  • Supprimer
 Non Définissez

Éléments enfants

Élément Description Condition requise
Mot clé (dans EventProvider) Décrit le mot clé suivi d’événements pour Windows (ETW) pour un fournisseur en mode utilisateur. Obligatoire, un ou plusieurs.

Éléments parents

Élément Description
Eventprovider Représente un fournisseur d’événements pour le profil.
EventProviderId Représente un identificateur de fournisseur d’événements.

 Exemple

L’exemple de code suivant montre comment cet élément est utilisé.

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

Éléments

CustomKeyword

CaptureStateOnSave