CaptureStateOnSave no EventProvider

2024-07-17

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

< WindowsPerformanceRecorder>
- < Perfis>
  - < Eventprovider>
    - < CaptureStateOnSave>
  - < Perfil>
    - < Colecionadores>
      - < EventCollectorId>
        
        < EventProviderId>
        
        < CaptureStateOnSave>
        
        < Eventprovider>
        
        < CaptureStateOnSave>

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)

Partilhar via