Encabezado evntrace.h

Varias tecnologías usan este encabezado. Para más información, consulte:

• Seguimiento de eventos
• Referencia del controlador en modo kernel

evntrace.h contiene las siguientes interfaces de programación:

Functions

CloseTrace La función CloseTrace cierra una sesión de procesamiento de seguimiento que se creó con OpenTrace.
ControlTraceA La función ControlTraceA (ANSI) (evntrace.h) vacía, consulta, actualizaciones o detiene la sesión de seguimiento de eventos especificada.
ControlTraceW La función ControlTraceW (Unicode) (evntrace.h) vacía, consulta, actualizaciones o detiene la sesión de seguimiento de eventos especificada.
CreateTraceInstanceId Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función CreateTraceInstanceId para crear un identificador de transacción único y asignarlo a un identificador de registro. A continuación, el proveedor puede usar el identificador de transacción al llamar a la función TraceEventInstance.
EnableTrace Un controlador de sesión de seguimiento llama a EnableTrace para configurar cómo un proveedor de eventos ETW registra eventos en una sesión de seguimiento. La función EnableTraceEx2 reemplaza a esta función.
EnableTraceEx Un controlador de sesión de seguimiento llama a EnableTraceEx para configurar cómo un proveedor de eventos ETW registra eventos en una sesión de seguimiento. La función EnableTraceEx2 reemplaza a esta función.
EnableTraceEx2 Un controlador de sesión de seguimiento llama a EnableTraceEx2 para configurar cómo un proveedor de eventos ETW registra eventos en una sesión de seguimiento.
EnumerateTraceGuids Recupera información sobre los proveedores de seguimiento de eventos que se ejecutan actualmente en el equipo. La función EnumerateTraceGuidsEx sustituye a esta función.
EnumerateTraceGuidsEx Recupera información sobre los proveedores de seguimiento de eventos que se ejecutan actualmente en el equipo.
FlushTraceA La función FlushTraceA (ANSI) (evntrace.h) hace que una sesión de seguimiento de eventos entregue inmediatamente eventos almacenados en búfer para la sesión especificada.
FlushTraceW La función FlushTraceW (Unicode) (evntrace.h) hace que una sesión de seguimiento de eventos entregue inmediatamente eventos almacenados en búfer para la sesión especificada.
GetTraceEnableFlags Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función GetTraceEnableFlags para recuperar las marcas de habilitación especificadas por el controlador de seguimiento para indicar qué categoría de eventos se van a rastrear. Los proveedores llaman a esta función desde su función ControlCallback.
GetTraceEnableLevel Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función GetTraceEnableLevel para recuperar el nivel de habilitación especificado por el controlador de seguimiento para indicar qué nivel de eventos se van a rastrear. Los proveedores llaman a esta función desde su función ControlCallback.
GetTraceLoggerHandle Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función GetTraceLoggerHandle para recuperar el identificador de la sesión de seguimiento de eventos en la que debe escribir eventos. Los proveedores llaman a esta función desde su función ControlCallback.
OpenTraceA La función OpenTraceA (ANSI) (evntrace.h) abre un identificador de procesamiento de seguimiento ETW para consumir eventos de una sesión de seguimiento en tiempo real de ETW o un archivo de registro ETW.
OpenTraceFromBufferStream Crea una sesión de procesamiento de seguimiento que no está asociada directamente a ningún archivo o sesión activa.
OpenTraceFromFile Crea una sesión de procesamiento de seguimiento para procesar un archivo .etl de Tracelog.
OpenTraceFromRealTimeLogger Abre un identificador de procesamiento de seguimiento ETW para consumir eventos de una sesión de seguimiento en tiempo real de ETW o un archivo de registro ETW.
OpenTraceFromRealTimeLoggerWithAllocationOptions Crea una sesión de procesamiento de seguimiento asociada a una sesión ETW activa en tiempo real.
OpenTraceW La función OpenTraceW (Unicode) (evntrace.h) abre un identificador de procesamiento de seguimiento ETW para consumir eventos de una sesión de seguimiento en tiempo real de ETW o un archivo de registro ETW.
ProcessTrace Entrega eventos de una o varias sesiones de procesamiento de seguimiento al consumidor.
ProcessTraceAddBufferToBufferStream Proporciona un búfer de seguimiento ETW a una sesión de procesamiento creada por OpenTraceFromBufferStream.
ProcessTraceBufferDecrementReference Libera una referencia a un búfer agregado por ProcessTraceBufferIncrementReference.
ProcessTraceBufferIncrementReference Se llama durante bufferCallback en el búfer proporcionado para evitar que se libere hasta que el autor de la llamada se realice con él.
QueryAllTracesA La función QueryAllTracesA (ANSI) (evntrace.h) recupera las propiedades y estadísticas de todas las sesiones de seguimiento de eventos que el autor de la llamada puede consultar.
QueryAllTracesW La función QueryAllTracesW (Unicode) (evntrace.h) recupera las propiedades y estadísticas de todas las sesiones de seguimiento de eventos que el autor de la llamada puede consultar.
QueryTraceA La función QueryTraceA (ANSI) (evntrace.h) recupera la configuración de propiedades y las estadísticas de sesión para la sesión de seguimiento de eventos especificada.
QueryTraceProcessingHandle Recupera información sobre una sesión de procesamiento de seguimiento de ETW abierta por OpenTrace.
QueryTraceW La función QueryTraceW (Unicode) (evntrace.h) recupera la configuración de propiedades y las estadísticas de sesión para la sesión de seguimiento de eventos especificada.
RegisterTraceGuidsA La función RegisterTraceGuidsA (ANSI) (evntrace.h) es una función obsoleta y el código nuevo debe usar la alternativa proporcionada.
RegisterTraceGuidsW La función RegisterTraceGuidsW (Unicode) (evntrace.h) es una función obsoleta y el nuevo código debe usar la alternativa proporcionada.
RemoveTraceCallback La función RemoveTraceCallback impide que una función EventCallback reciba eventos para una clase de seguimiento de eventos. Esta función está obsoleta.
SetTraceCallback La función SetTraceCallback especifica una función EventCallback para procesar eventos para la clase de seguimiento de eventos especificada. Esta función está obsoleta.
StartTraceA La función StartTrace inicia una sesión de seguimiento de eventos. (ANSI)
StartTraceW La función StartTrace inicia una sesión de seguimiento de eventos. (Unicode)
StopTraceA La función StopTraceA (ANSI) (evntrace.h) detiene la sesión de seguimiento de eventos especificada. La función ControlTrace sustituye a esta función.
StopTraceW La función StopTraceW (Unicode) (evntrace.h) detiene la sesión de seguimiento de eventos especificada. La función ControlTrace sustituye a esta función.
TraceEvent Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función TraceEvent para enviar un evento estructurado a una sesión de seguimiento de eventos.
TraceEventInstance Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función TraceEventInstance para enviar un evento estructurado a una sesión de seguimiento de eventos con un identificador de instancia.
TraceMessage Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función TraceMessage para enviar un evento basado en mensajes (WPP basado en TMF) a una sesión de seguimiento de eventos.
TraceMessageVa Un proveedor de eventos basado en RegisterTraceGuids ("clásico") usa la función TraceMessageVa para enviar un evento basado en mensajes (WPP basado en TMF) a una sesión de seguimiento de eventos mediante parámetros va_list.
TraceQueryInformation Proporciona información sobre una sesión de seguimiento de eventos.
TraceSetInformation Configura la configuración de la sesión de seguimiento de eventos.
AnularregisterTraceGuids Anula el registro de un proveedor de seguimiento de eventos ETW "clásico" (estilo Windows 2000) que se registró mediante RegisterTraceGuids.
UpdateTraceA La función UpdateTraceA (ANSI) (evntrace.h) actualiza el valor de propiedad de la sesión de seguimiento de eventos especificada.
UpdateTraceW La función UpdateTraceW (Unicode) (evntrace.h) actualiza el valor de propiedad de la sesión de seguimiento de eventos especificada.

Funciones de devolución de llamada

PETW_BUFFER_CALLBACK Definición de función para BufferCallback que ProcessTrace invocará.
PETW_BUFFER_COMPLETION_CALLBACK Definición de función para la devolución de llamada que se desencadenará cuando ProcessTraceAddBufferToBufferStream finalice con un búfer. Esta devolución de llamada normalmente debe liberar el búfer según corresponda.
PEVENT_CALLBACK Los consumidores de eventos ETW implementan esta devolución de llamada para recibir eventos de una sesión de procesamiento de seguimiento. La devolución de llamada EventRecordCallback reemplaza a esta devolución de llamada.
PEVENT_RECORD_CALLBACK Los consumidores de eventos ETW implementan esta devolución de llamada para recibir eventos de una sesión de procesamiento de seguimiento. El tipo PEVENT_RECORD_CALLBACK define un puntero a esta función de devolución de llamada. EventRecordCallback es un marcador de posición para el nombre de función definido por la aplicación.
PEVENT_TRACE_BUFFER_CALLBACKA La función PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) obtiene estadísticas sobre cada búfer de eventos que ETW envía durante una sesión de procesamiento de seguimiento.
PEVENT_TRACE_BUFFER_CALLBACKW La función PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) obtiene estadísticas sobre cada búfer de eventos que ETW envía durante una sesión de procesamiento de seguimiento.
WMIDPREQUEST Un proveedor de eventos basado en RegisterTraceGuids ("clásico") implementa esta función para recibir notificaciones de controladores. El tipo WMIDPREQUEST define un puntero a esta función de devolución de llamada. ControlCallback es un marcador de posición para el nombre de función definido por la aplicación.

Estructuras

CLASSIC_EVENT_ID Identifica el evento de kernel para el que desea habilitar el seguimiento de la pila de llamadas.
ENABLE_TRACE_PARAMETERS Contiene información usada para habilitar un proveedor a través de EnableTraceEx2.
ENABLE_TRACE_PARAMETERS_V1 Contiene información usada para habilitar un proveedor a través de EnableTraceEx2. Esta estructura está obsoleta.
ETW_BUFFER_CALLBACK_INFORMATION Se proporciona a BufferCallback como parámetro ConsumerInfo y proporciona detalles sobre la sesión de procesamiento actual.
ETW_BUFFER_CONTEXT Proporciona información de contexto sobre el evento.
ETW_BUFFER_HEADER Estructura de encabezado de un búfer ETW.
ETW_OPEN_TRACE_OPTIONS Proporciona parámetros de configuración a las funciones OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions.
ETW_TRACE_PARTITION_INFORMATION Contiene información de partición extraída de un seguimiento ETW.
EVENT_INSTANCE_HEADER La estructura EVENT_INSTANCE_HEADER contiene información de seguimiento de eventos estándar común a todos los eventos escritos por TraceEventInstance.
EVENT_INSTANCE_INFO La estructura EVENT_INSTANCE_INFO asigna un identificador de transacción único a una clase de seguimiento de eventos registrada para TraceEventInstance.
EVENT_TRACE La estructura EVENT_TRACE se usa para entregar información de eventos a un consumidor de seguimiento de eventos.
EVENT_TRACE_HEADER La estructura EVENT_TRACE_HEADER contiene información de seguimiento de eventos estándar común a todos los eventos escritos por TraceEvent.
EVENT_TRACE_LOGFILEA La estructura de EVENT_TRACE_LOGFILEA (ANSI) (evntrace.h) almacena información sobre un origen de datos de seguimiento.
EVENT_TRACE_LOGFILEW La estructura EVENT_TRACE_LOGFILEW (Unicode) (evntrace.h) almacena información sobre un origen de datos de seguimiento.
EVENT_TRACE_PROPERTIES La estructura de EVENT_TRACE_PROPERTIES contiene información sobre una sesión de seguimiento de eventos y se usa con API como StartTrace y ControlTrace.
EVENT_TRACE_PROPERTIES_V2 La estructura EVENT_TRACE_PROPERTIES_V2 contiene información sobre una sesión de seguimiento de eventos y se usa con API como StartTrace y ControlTrace.
MOF_FIELD Puede usar las estructuras de MOF_FIELD para anexar datos de eventos a las estructuras de EVENT_TRACE_HEADER o EVENT_INSTANCE_HEADER.
TRACE_ENABLE_INFO Define la sesión y la información que la sesión usó para habilitar el proveedor.
TRACE_GUID_INFO Devuelto por EnumerateTraceGuidsEx. Define el encabezado en la lista de sesiones que han habilitado un proveedor.
TRACE_GUID_PROPERTIES Devuelto por EnumerateTraceGuids. Contiene información sobre un proveedor de seguimiento de eventos.
TRACE_GUID_REGISTRATION Se usa con RegisterTraceGuids para registrar clases de seguimiento de eventos.
TRACE_LOGFILE_HEADER La estructura TRACE_LOGFILE_HEADER contiene información sobre una sesión de seguimiento de eventos y sus eventos.
TRACE_PERIODIC_CAPTURE_STATE_INFO Se usa con TraceQueryInformation y TraceSetInformation para obtener o establecer información relacionada con un estado de captura periódico.
TRACE_PROVIDER_INSTANCE_INFO Define una instancia del GUID del proveedor.
TRACE_VERSION_INFO Determina la información de versión de la sesión tracelogging.

Enumeraciones

ETW_PROCESS_HANDLE_INFO_TYPE Especifica la operación que se realizará en una sesión de procesamiento de seguimiento.
ETW_PROCESS_TRACE_MODES Especifica los modos de seguimiento de procesos admitidos.
TRACE_QUERY_INFO_CLASS Se usa con EnumerateTraceGuidsEx y TraceSetInformation para especificar un tipo de información de seguimiento.