Partager via

CaptureStateOnDemand dans EventProvider

  • Article

Représente une collection de mots clés qui décrivent les événements à capturer à la demande lors de l’enregistrement. La bibliothèque demande au fournisseur de consigner ses informations d’état lorsque le fournisseur est activé. Vous pouvez déclencher l’état de capture du fournisseur par wpr -capturestateondemand commande. 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

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

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>
  <CaptureStateOnDemand>
    <Keyword Value="0xff4"/> <!-- Provider is  enabled with these keywords when user initiates wpr -capturestateondemand command. -->
  </CaptureStateOnDemand>
</EventProvider>

Éléments

Mot clé (dans SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave