Macro TraceLoggingEventTag (traceloggingprovider.h)

Macro contenedora traceLogging que establece la etiqueta de evento para el evento.

Sintaxis

void TraceLoggingEventTag(
  [in]  eventTag
);

Parámetros

[in] eventTag

Se trata de una constante en tiempo de compilación que especifica el valor de la etiqueta de evento.

En C++, puede ser cualquier valor del intervalo de 0 a 0x0FFFFFFF.

En C, puede ser cualquier valor del intervalo comprendido entre 0 y 0x0FFFA000 con los 14 bits bajos establecidos en 0.

Valor devuelto

None

Observaciones

TraceLoggingEventTag(eventTag) se puede usar como parámetro para una invocación de una macro TraceLoggingWrite para establecer la etiqueta del evento.

El consumidor de eventos define la semántica de la etiqueta. Durante el procesamiento de eventos, el valor de etiqueta se puede recuperar del campo Etiquetas TRACE_EVENT_INFO .

La convención de esquema tracelogging codifica las etiquetas como campo de 28 bits mediante una cadena de hasta cuatro bytes con el bit superior más usado como un bit "chain" (4 bytes * 7 bits utilizables por byte = 28 bits). Los datos se codifican primero en bytes más significativos. En C, TraceLoggingWrite se limita a una codificación de 2 bytes para la etiqueta, por lo que los 14 bits bajos de la etiqueta deben ser 0.

Si no se proporcionan parámetros TraceLoggingEventTag para un evento, no se transmite ninguna etiqueta para el evento y el evento tendrá una etiqueta de 0. Si se proporcionan varios parámetros TraceLoggingEventTag, los valores de etiqueta son OR'ed juntos.

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

TraceLoggingWrite

Macros contenedoras traceLogging

TRACE_EVENT_INFO