Partilhar via


CaptureStateOnDemand em EventProvider

Representa uma coleção de palavras-chave que descrevem eventos a serem capturados sob demanda durante a gravação. A biblioteca solicita que o provedor registre suas informações de estado quando o provedor estiver habilitado. Você pode disparar o capturestate do provedor por wpr -capturestateondemand comando. Se o atributo Operation for especificado, os elementos Keyword poderão ser definidos ou adicionados à coleção.

Hierarquia de elementos

Syntax

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnDemand>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Padrão
Operação Indica se as palavras-chave devem ser definidas ou adicionadas. Esse atributo pode ter um dos seguintes valores:
  • Definir
  • Adicionar
  • Remover
Não Definir

Elementos filho

Elemento Descrição Requisito
Palavra-chave (em EventProvider) Descreve a palavra-chave de rastreamento de eventos para Windows (ETW) para um provedor de modo de usuário. Obrigatório, um ou mais.

Elementos pai

Elemento Descrição
Eventprovider Representa um provedor de eventos para o perfil.
EventProviderId Representa um identificador do provedor de eventos.

Exemplo

O exemplo de código a seguir mostra como esse elemento é usado.

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

Elementos

Palavra-chave (em SystemProvider)

CustomKeyword

CaptureStateOnStart

CaptureStateOnSave