Compartir a través de

CaptureStateOnStart en EventProvider

  • Artículo

Representa una colección de palabras clave que describen los eventos que se van a capturar al principio de una grabación. La biblioteca solicita al proveedor que registre su información de estado cuando el proveedor está habilitado. Si se especifica el atributo Operation , los elementos Keyword se pueden establecer o agregar a la colección.

Jerarquía de elementos

Sintaxis

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

Atributos y elementos

Atributos

Atributo Descripción Tipo de datos Obligatorio Valor predeterminado
operación Indica si se deben establecer o agregar palabras clave. Este atributo puede tener uno de los siguientes valores:
  • Set
  • Sumar
  • Quitar
 No Set

Elementos secundarios

Elemento Descripción Requisito
Palabra clave (en EventProvider) Describe la palabra clave Seguimiento de eventos para Windows (ETW) para un proveedor en modo de usuario. Obligatorio, uno o varios.

Elementos primarios

Elemento Descripción
EventProvider Representa un proveedor de eventos para el perfil.
EventProviderId Representa un identificador de proveedor de eventos.

Ejemplo

En el ejemplo de código siguiente se muestra cómo se usa este 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>

Elements

CustomKeyword

CaptureStateOnSave