Condividi tramite

CaptureStateOnDemand in EventProvider

  • Articolo

Rappresenta una raccolta di parole chiave che descrivono gli eventi da acquisire su richiesta durante la registrazione. La libreria richiede al provider di registrare le informazioni sullo stato quando il provider è abilitato. È possibile attivare lo stato di acquisizione del provider tramite wpr -capturestateondemand il comando . Se viene specificato l'attributo Operation , gli elementi Keyword possono essere impostati o aggiunti alla raccolta.

Gerarchia degli elementi

Sintassi

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

Attributi ed elementi

Attributi

Attributo Descrizione Tipo di dati Richiesto Predefinito
Operazione Indica se le parole chiave devono essere impostate o aggiunte. Questo attributo può avere uno dei valori seguenti:
  • Set
  • Add
  • Rimuovi
 No Set

Elementi figlio

Elemento Descrizione Requisito
Parola chiave (in EventProvider) Descrive la parola chiave Event Tracing for Windows (ETW) per un provider in modalità utente. Obbligatorio, uno o più.

Elementi padre

Elemento Descrizione
EventProvider Rappresenta un provider di eventi per il profilo.
EventProviderId Rappresenta un identificatore del provider di eventi.

Esempio

Nell'esempio di codice seguente viene illustrato come viene usato questo elemento.

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

Elementi

Parola chiave (in SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave