Compartir a través de

CaptureStateOnDemand en EventProvider

  • Artículo

Representa una colección de palabras clave que describen los eventos que se van a capturar a petición durante la grabación. La biblioteca solicita al proveedor que registre su información de estado cuando el proveedor está habilitado. Puede desencadenar el valor capturestate del proveedor mediante wpr -capturestateondemand el comando . Si se especifica el atributo Operation , los elementos Keyword se pueden establecer o agregar a la colección.

Jerarquía de elementos

Sintaxis

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

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

Elements

Palabra clave (en SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave