TraceLoggingEventTag 宏 (traceloggingprovider.h)

  • 项目

TraceLogging 包装宏 ，用于设置事件的事件标记。

语法

void TraceLoggingEventTag(
  [in]  eventTag
);

参数

[in] eventTag

这是指定事件标记值的编译时常量。

在 C++ 中，这可以是 0 到 0x0FFFFFFF 范围内的任何值。

在 C 中，这可以是范围 0 到 0x0FFFA000且低 14 位设置为 0 的任何值。

返回值

无

备注

TraceLoggingEventTag(eventTag) 可用作 TraceLoggingWrite 宏调用的参数，以设置事件的 标记。

标记的语义由事件使用者定义。 在事件处理期间，可以从 “TRACE_EVENT_INFO 标记”字段中检索标记值。

TraceLogging 架构约定使用最多 4 个字节的链将标记编码为 28 位字段，其中最高位用作“链”位 (4 字节 * 7 个可用位/字节 = 28 位) 。 首先对数据进行最有效字节编码。 在 C 中， TraceLoggingWrite 限制为标记的 2 字节编码，因此标记的低 14 位必须为 0。

如果没有为事件提供 TraceLoggingEventTag 参数，则不会为该事件传输任何标记，并且该事件的标记将为 0。 如果提供了多个 TraceLoggingEventTag 参数，则标记值将 OR 组合在一起。

要求

要求 值
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 traceloggingprovider.h

另请参阅

TraceLoggingWrite

TraceLogging 包装宏

TRACE_EVENT_INFO