estructura ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)

La estructura de ENABLE_TRACE_PARAMETERS_V1 contiene información utilizada para habilitar un proveedor a través de EnableTraceEx2. Esta estructura está obsoleta. Use ENABLE_TRACE_PARAMETERS en su lugar.

Sintaxis

typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
  ULONG                    Version;
  ULONG                    EnableProperty;
  ULONG                    ControlFlags;
  GUID                     SourceId;
  PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;

Miembros

Version

Establezca en ENABLE_TRACE_PARAMETERS_VERSION (1).

EnableProperty

Información opcional que ETW puede incluir al escribir el evento. Los datos se escriben en la sección de elementos de datos extendidos del evento. Para incluir la información opcional, especifique una o varias de las marcas siguientes; de lo contrario, establezca en cero.

• EVENT_ENABLE_PROPERTY_SID

  Incluya en los datos extendidos el identificador de seguridad (SID) del usuario.

• EVENT_ENABLE_PROPERTY_TS_ID

  Incluya en los datos extendidos el identificador de sesión de terminal.

• EVENT_ENABLE_PROPERTY_STACK_TRACE

  Agregue un seguimiento de pila de llamadas a los datos extendidos de eventos escritos mediante EventWrite.

  Nota:

  ETW quitará el evento si el tamaño total del evento supera los 64 000. Si el proveedor registra eventos de tamaño a 64 000 como máximo, es posible que la habilitación de la captura de pila provoque la pérdida del evento.

  Si la pila es mayor que el número máximo de fotogramas (192), los fotogramas se cortarán desde la parte inferior de la pila.

  Para los consumidores, los eventos incluirán el EVENT_EXTENDED_ITEM_STACK_TRACE32 o EVENT_EXTENDED_ITEM_STACK_TRACE64 elemento extendido. Tenga en cuenta que los consumidores de 32 bits pueden recibir seguimientos de pila de 64 bits de procesos de 64 bits.

ControlFlags

Reservado. Establecer en 0.

SourceId

GUID que identifica de forma única el autor de la llamada que habilita o deshabilita el proveedor. Si el proveedor no implementa EnableCallback, no se usa el GUID.

EnableFilterDesc

Estructura EVENT_FILTER_DESCRIPTOR que apunta a los datos de filtro. El proveedor usa datos de filtro para evitar que los eventos que coincidan con los criterios de filtro se escriban en la sesión. El proveedor determina el diseño de los datos y cómo aplica el filtro a los datos del evento. Una sesión solo puede pasar un filtro al proveedor.

Una sesión puede llamar a la función TdhEnumerateProviderFilters para determinar los filtros esquematizados que puede pasar al proveedor.

Comentarios

ENABLE_TRACE_PARAMETERS_V1 está obsoleto. La estructura ENABLE_TRACE_PARAMETERS es una estructura de la versión 2 y reemplaza la estructura de ENABLE_TRACE_PARAMETERS_V1 .

Normalmente, en equipos de 64 bits, no se puede capturar la pila del kernel en determinados contextos cuando no se permiten errores de página. Para habilitar la marcha de la pila del kernel en x64, establezca el valor del DisablePagingExecutive Registro de administración de memoria en 1. El DisablePagingExecutive valor del Registro se encuentra bajo la siguiente clave del Registro: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Esto solo debe realizarse con fines de diagnóstico temporal porque aumenta el uso de memoria del sistema.

Requisitos

Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	evntrace.h

Consulte también

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2