Compartilhar via

StackKeywordLevelFilter

  • Artigo

O elemento StackKeywordLevelFilter especifica palavras-chave de evento e nível para incluir ou excluir eventos stackwalk.

Observação

Disponível em Windows 10, versão 1709 e posterior.

Hierarquia de elementos

Syntax

<StackKeywordLevelFilter FilterIn = "true|false" Level = "unsigned byte" Operation = "Set|Add|Remove" >

  <!-- Child elements -->
  <keyword>

</StackKeywordLevelFilter>

Atributos e elementos

Atributos

Atributo Descrição Tipo de dados Obrigatório Padrão
FilterIn Indica se os eventos de stackwalk especificados devem ser incluídos ou excluídos. booleano Sim
Level nível de evento Bytes não assinados Nã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 Palavra-chave de eventos Obrigatório

Elementos pai

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

Comentário

Quando o stack walking está habilitado para um provedor, a pilha é capturada para todos os eventos gerados pelo provedor. Na maioria das vezes, o usuário só está interessado na pilha de apenas determinado número de eventos. Esse elemento permite habilitar ou desabilitar o andamento da pilha com base em palavra-chave e nível.

Embora o ETW dê suporte a conteúdo avançado e filtragem de atributos, os eventos devem ser filtrados principalmente com base em filtros de escopo ou por meio de nível e palavra-chave para menos sobrecarga de CPU.

Exemplo

    <EventProvider Id="EventProvider_TraceLogGen" Name="*TraceLogGen">
      <StackKeywordLevelFilter FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
      </StackKeywordLevelFilter>
    </EventProvider>

Elementos