Compartilhar via


CaptureStateOnStart em EventProvider

Representa uma coleção de palavras-chave que descrevem os eventos a serem capturados no início de uma gravação. A biblioteca solicita que o provedor registre suas informações de estado quando o provedor estiver habilitado. Se o atributo Operation for especificado, os elementos Keyword poderão ser definidos ou adicionados à coleção.

Hierarquia de elementos

Syntax

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnStart>

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 o ETW (Rastreamento de Eventos para Windows) palavra-chave 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 de 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>
  <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>

Elementos

CustomKeyword

CaptureStateOnSave