TraceLoggingEventTag-Makro (traceloggingprovider.h)
TraceLogging-Wrappermakro , das das Ereignistag für das Ereignis festlegt.
Syntax
void TraceLoggingEventTag(
[in] eventTag
);
Parameter
[in] eventTag
Dies ist eine Kompilierzeitkonstante, die den Wert des Ereignistags angibt.
In C++ kann dies ein beliebiger Wert im Bereich von 0 bis 0x0FFFFFFF sein.
In C kann dies ein beliebiger Wert im Bereich von 0 bis 0x0FFFA000 sein, wobei die niedrigen 14 Bits auf 0 festgelegt sind.
Rückgabewert
Keine
Bemerkungen
TraceLoggingEventTag(eventTag) kann als Parameter für einen Aufruf eines TraceLoggingWrite-Makros verwendet werden, um das Tag des Ereignisses festzulegen.
Die Semantik des Tags wird vom Ereignisconsumer definiert. Während der Ereignisverarbeitung kann der Tagwert aus dem Feld TRACE_EVENT_INFO Tags abgerufen werden.
Die TraceLogging-Schemakonvention codiert Tags als 28-Bit-Feld, indem eine Kette von bis zu vier Bytes verwendet wird, wobei das obere Bit als "Chain"-Bit verwendet wird (4 Byte * 7 verwendbare Bits pro Byte = 28 Bit). Die Daten werden zuerst mit dem wichtigsten Byte codiert. In C ist TraceLoggingWrite auf eine 2-Byte-Codierung für das Tag beschränkt, sodass die niedrigen 14 Bits des Tags 0 sein müssen.
Wenn keine TraceLoggingEventTag-Parameter für ein Ereignis bereitgestellt werden, wird kein Tag für das Ereignis übertragen, und das Ereignis weist das Tag 0 auf. Wenn mehrere TraceLoggingEventTag-Parameter bereitgestellt werden, werden die Tagwerte zusammen OR'ed.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | traceloggingprovider.h |