Condividi tramite


Macro TraceLoggingEventTag (traceloggingprovider.h)

Macro wrapper TraceLogging che imposta il tag evento per l'evento.

Sintassi

void TraceLoggingEventTag(
  [in]  eventTag
);

Parametri

[in] eventTag

Si tratta di una costante in fase di compilazione che specifica il valore del tag evento.

In C++, può essere qualsiasi valore compreso nell'intervallo da 0 a 0x0FFFFFFF.

In C questo valore può essere qualsiasi valore compreso nell'intervallo da 0 a 0x0FFFA000 con i 14 bit bassi impostati su 0.

Valore restituito

nessuno

Osservazioni

TraceLoggingEventTag(eventTag) può essere usato come parametro per una chiamata di una macro TraceLoggingWrite per impostare il tag dell'evento.

La semantica del tag è definita dal consumer di eventi. Durante l'elaborazione degli eventi, il valore del tag può essere recuperato dal campo tag TRACE_EVENT_INFO .

La convenzione dello schema TraceLogging codifica i tag come campo a 28 bit usando una catena di fino a quattro byte con il bit più alto usato come bit "chain" (4 byte * 7 bit utilizzabili per byte = 28 bit). I dati vengono codificati per primi in byte più significativi. In C TraceLoggingWrite è limitato a una codifica a 2 byte per il tag, quindi i 14 bit bassi del tag devono essere 0.

Se non vengono forniti parametri TraceLoggingEventTag per un evento, non viene trasmesso alcun tag per l'evento e l'evento avrà un tag pari a 0. Se vengono forniti più parametri TraceLoggingEventTag, i valori dei tag sono OR'ed insieme.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione traceloggingprovider.h

Vedi anche

TraceLoggingWrite

Macro wrapper TraceLogging

TRACE_EVENT_INFO