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

Weitere Informationen

TraceLoggingWrite

TraceLogging-Wrappermakros

TRACE_EVENT_INFO