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 活动的开始和结束，如下所示：

  1. 生成跟踪中唯一的活动 ID，通常使用 EventActivityIdControl 或 UuidCreate。
  2. 编写操作码 = START、活动 ID = 生成的活动 ID 和相关活动 ID = 父活动 ID (的开始事件;如果没有父活动 ID) ，则为 NULL。
  3. 使用 opcode = INFO、活动 ID = 生成的活动 ID 编写任意数量的活动信息事件。
  4. 使用 opcode = STOP，活动 ID = 生成的活动 ID 编写停止事件。

然后，跟踪解码工具将能够根据事件的活动 ID 将这些事件组织到组中。

要求

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

另请参阅

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

TraceLogging 包装宏