Compartilhar via


CaptureStateOnSave no EventProvider

Representa uma coleção de palavras-chave que descrevem eventos a serem capturados quando um rastreamento é salvo. A biblioteca solicita que o provedor registre suas informações de estado quando o coletor é salvo. Se o atributo Operation for especificado, os elementos Keyword poderão ser definidos ou adicionados à coleção.

Hierarquia de elementos

Syntax

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

  <!-- Child elements -->
  Keyword

</CaptureStateOnSave>

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="EventProvider_DWMWin32k_CaptureState" Name="e7ef96be-969f-414f-97d7-3ddb7b558ccc" NonPagedMemory="true" CaptureStateOnly="true" > 
  <!-- CaptureStateOnly="true" means provider is not enabled throughout the tracing session. -->
  <CaptureStateOnSave>
    <Keyword Value="0x80000"/> <!-- Provider is enabled with these keywords when tracing is saved. -->
  </CaptureStateOnSave>
</EventProvider>

Elementos

CustomKeyword

CaptureStateOnStart

CaptureStateOnDemand(in EventProvider)