Partager via

CaptureStateOnSave dans EventProvider

  • Article

Représente une collection de mots clés qui décrivent les événements à capturer lors de l’enregistrement d’une trace. La bibliothèque demande au fournisseur de consigner ses informations d’état lors de l’enregistrement du collecteur. 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

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnSave>

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="EventProvider_DWMWin32k_CaptureState" Name="e7ef96be-969f-414f-97d7-3ddb7b558ccc" NonPagedMemory="true" CaptureStateOnly="true" > 
  <!-- CaptureStateOnly="true" means provider is not enabled throughout the tracing session. -->
  <CaptureStateOnSave>
    <Keyword Value="0x80000"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

Éléments

CustomKeyword

CaptureStateOnStart

CaptureStateOnDemand(in EventProvider)