Condividi tramite

CaptureStateOnStart in EventProvider

  • Articolo

Rappresenta una raccolta di parole chiave che descrivono gli eventi da acquisire all'inizio di una registrazione. La libreria richiede al provider di registrare le informazioni sullo stato quando il provider è abilitato. Se viene specificato l'attributo Operation , gli elementi Keyword possono essere impostati o aggiunti alla raccolta.

Gerarchia degli elementi

Sintassi

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

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

Elementi

CustomKeyword

CaptureStateOnSave