TraceLoggingEventTag macro (traceloggingprovider.h)

Wrapper macro for setting the event's tag(s).

Syntax

void TraceLoggingEventTag(
  [in]  eventTag
);

Parameters

[in] eventTag

A compile-time constant in the range of 0x00200000-0x0FE00000.

Return value

None

Remarks

The semantics of the tags are defined by the event consumer. During event processing, this tag can be retrieved from the TRACE_EVENT_INFO Tags field.

The TraceLogging schema convention encodes tags as 28-bit fields by using a chain of up to four bytes with the upper-most bit used as a 'chain' bit (4*7 = 28). Data is encoded most-significant byte first. TraceLoggingWrite and TraceLoggingEventTag only supports encoding a single byte of tag data, which must then contain the upper-most range of seven bits, thus 0x0FE00000.

If no parameters are provided, no tag is transmitted for the event. If multiple args are provided, they are OR'ed together.

Requirements

   
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2012 R2
Target Platform Windows
Header traceloggingprovider.h