EventNameFilters

El elemento EventNameFilters incluye o excluye eventos de registro de seguimiento en función de sus nombres.

Nota

Disponible en Windows 10, versión 1709 y posteriores.

Jerarquía de elementos

• < WindowsPerformanceRecorder>
  • < Perfiles>
    • < EventProvider>
      • < EventNameFilters>
    • < Perfil>
      • < Coleccionistas>
        • < EventCollectorId>
          • < EventProviders>
            • < EventProvider>
              • < EventNameFilters>

Sintaxis

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

  <!-- Child elements -->
  <Keyword>
  <EventName>

</EventNameFilters>

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
FilterIn	Indica si se deben incluir o excluir los eventos de stackwalk especificados.	boolean	Sí
Level	nivel de evento	Byte sin signo	No
operación	Indica si se deben establecer o agregar palabras clave.	Este atributo puede tener uno de los siguientes valores: Set Sumar Quitar	No	Set

Elementos secundarios

Elemento	Descripción	Requisito
EventName	Un nombre de evento de registro de seguimiento.	Obligatorio, 1 o más.
Palabra clave	Palabra clave Event	Opcionales

Elementos primarios

Elemento	Descripción
EventProvider	Representa un proveedor de eventos para el perfil.

Comentario

El elemento EventNameFilters habilita el filtrado de eventos a través de EVENT_FILTER_DESCRIPTOR, Type EVENT_FILTER_TYPE_EVENT_NAME.

Aunque ETW admite una carga eficaz y el filtrado de atributos, los eventos deben filtrarse principalmente filtros de ámbito basados o a través de nivel y palabra clave para una menor sobrecarga de CPU.

Ejemplo

    <EventProvider Id="EventProvider_TraceLogGen" Name="3970F9cf-2c0c-4f11-b1cc-e3a1e9958833">
      <EventNameFilters FilterIn="true" Level="5">
        <Keyword Value="0x10000000000000"/>
        <EventName Value="Preset1"/>
        <EventName Value="Preset2"/>
      </EventNameFilters>
    </EventProvider>

Temas relacionados

Elements