TraceLoggingOpcode 宏 (traceloggingprovider.h)
TraceLogging 包装宏 ，用于设置事件的操作码。
语法
void TraceLoggingOpcode(
[in] eventOpcode
);
参数
[in] eventOpcode
用于标记具有特殊语义的事件的 8 位数字。 此值必须是 0 到 255 范围内的编译时常量。
跟踪解码器将使用操作码来组织和关联事件。
全局识别的操作码值在 中 winmeta.h定义。 大多数事件使用 0 (WINEVENT_OPCODE_INFO) 来指示事件没有特殊语义。
可以为操作码值 10 到 239 提供用户定义的语义。
有关事件操作码的详细信息，请参阅 EVENT_DESCRIPTOR 。
返回值
无
备注
TraceLoggingOpcode(eventOpcode) 可用作 TraceLoggingWrite 宏调用的参数，以设置事件的操作码。
如果未向 TraceLoggingWrite 调用提供 TraceLoggingOpcode 宏，则事件的默认操作码为 0 (WINEVENT_OPCODE_INFO) 。 如果提供了多个 TraceLoggingOpcode 宏，则使用最后一个值。
操作码WINEVENT_OPCODE_START (1) 和 WINEVENT_OPCODE_STOP (2) 用于指示 ETW 活动的开始和结束，如下所示：
- 生成跟踪中唯一的活动 ID，通常使用 EventActivityIdControl 或 UuidCreate。
- 编写操作码 = START、活动 ID = 生成的活动 ID 和相关活动 ID = 父活动 ID (的开始事件;如果没有父活动 ID) ，则为 NULL。
- 使用 opcode = INFO、活动 ID = 生成的活动 ID 编写任意数量的活动信息事件。
- 使用 opcode = STOP，活动 ID = 生成的活动 ID 编写停止事件。
然后，跟踪解码工具将能够根据事件的活动 ID 将这些事件组织到组中。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | traceloggingprovider.h |