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 |