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 |