Macro TraceLoggingEventTag (traceloggingprovider.h)

Macro wrapper traceLogging que define a marca de evento para o evento.

Sintaxe

void TraceLoggingEventTag(
  [in]  eventTag
);

Parâmetros

[in] eventTag

Essa é uma constante de tempo de compilação que especifica o valor da marca de evento.

No C++, esse pode ser qualquer valor no intervalo de 0 a 0x0FFFFFFF.

Em C, isso pode ser qualquer valor no intervalo de 0 a 0x0FFFA000 com os 14 bits baixos definidos como 0.

Retornar valor

Nenhum

Comentários

TraceLoggingEventTag(eventTag) pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite para definir a marca do evento.

A semântica da marca é definida pelo consumidor do evento. Durante o processamento de eventos, o valor da marca pode ser recuperado do campo Marcas de TRACE_EVENT_INFO .

A convenção de esquema TraceLogging codifica marcas como campo de 28 bits usando uma cadeia de até quatro bytes com o bit mais alto usado como um bit "chain" (4 bytes * 7 bits utilizáveis por byte = 28 bits). Os dados são codificados primeiro em bytes mais significativos. Em C, TraceLoggingWrite é limitado a uma codificação de 2 bytes para a marca, portanto, os 14 bits baixos da marca devem ser 0.

Se nenhum parâmetro TraceLoggingEventTag for fornecido para um evento, nenhuma marca será transmitida para o evento e o evento terá uma marca de 0. Se vários parâmetros TraceLoggingEventTag forem fornecidos, os valores de marca serão OR'ed juntos.

Requisitos

Confira também

TraceLoggingWrite

Macros de wrapper traceLogging

TRACE_EVENT_INFO