Macro TraceLoggingOpcode (traceloggingprovider.h)

  • Artículo

Macro contenedora traceLogging que establece el código de operación para el evento.

Sintaxis

void TraceLoggingOpcode(
  [in]  eventOpcode
);

Parámetros

[in] eventOpcode

Número de 8 bits usado para marcar eventos con semántica especial. Este valor debe ser una constante en tiempo de compilación en el intervalo de 0 a 255.

Los descodificadores de seguimiento usarán el código de operación para organizar y correlacionar eventos. Los valores de código de operación reconocidos globalmente se definen en winmeta.h. La mayoría de los eventos usan 0 (WINEVENT_OPCODE_INFO) para indicar que el evento no tiene semántica especial. Los valores de opcode de 10 a 239 se pueden proporcionar semántica definida por el usuario.

Consulte EVENT_DESCRIPTOR para obtener más información sobre el código de operación del evento.

Valor devuelto

None

Observaciones

TraceLoggingOpcode(eventOpcode) se puede usar como parámetro para una invocación de una macro TraceLoggingWrite para establecer el código de operación del evento.

Si no se proporcionan macros TraceLoggingOpcode a una llamada TraceLoggingWrite , el código de operación predeterminado del evento es 0 (WINEVENT_OPCODE_INFO). Si se proporcionan varias macros TraceLoggingOpcode , se usa el último valor.

Los códigos de operación WINEVENT_OPCODE_START (1) y WINEVENT_OPCODE_STOP (2) se usan para indicar el principio y el final de las actividades ETW de la siguiente manera:

  1. Genere un identificador de actividad que sea único dentro del seguimiento, normalmente mediante EventActivityIdControl o UuidCreate.
  2. Escriba un evento de inicio con opcode = START, id. de actividad = el identificador de actividad generado y el identificador de actividad relacionado = el identificador de actividad primario (o NULL si no hay ningún identificador de actividad primario).
  3. Escriba cualquier número de eventos de información de actividad con opcode = INFO, id. de actividad = el identificador de actividad generado.
  4. Escriba un evento stop con opcode = STOP, id. de actividad = el identificador de actividad generado.

Las herramientas de descodificación de seguimiento podrán organizar estos eventos en grupos en función de sus identificadores de actividad.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado traceloggingprovider.h

Consulte también

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

Macros contenedoras traceLogging