TraceLoggingOpcode 宏 (traceloggingprovider.h)

語法

void TraceLoggingOpcode(
  [in]  eventOpcode
);

[in] eventOpcode

用來以特殊語意標記事件的8位數位。這個值必須是範圍 0 到 255 中的編譯時間常數。

追蹤譯碼器會使用 opcode 來組織和相互關聯事件。全域辨識的 opcode 值定義於中 winmeta.h。大部分的事件都會使用 0 (WINEVENT_OPCODE_INFO) 來表示事件沒有特殊語意。 Opcode 值 10 到 239 可以指定使用者定義的語意。

如需事件 opcode 的詳細資訊，請參閱 EVENT_DESCRIPTOR 。

無

TraceLoggingOpcode(eventOpcode) 可作為 TraceLoggingWrite 宏調用的參數，以設定事件的 opcode。

如果未將 TraceLoggingOpcode 宏提供給 TraceLoggingWrite 呼叫，事件的預設 opcode 為 0 (WINEVENT_OPCODE_INFO) 。如果提供了多個 TraceLoggingOpcode 宏，則會使用最後一個值。

Opcodes WINEVENT_OPCODE_START (1) 和 WINEVENT_OPCODE_STOP (2) 用來指出 ETW 活動的開頭和結尾，如下所示：

產生追蹤內唯一的活動標識符，通常使用 EventActivityIdControl 或 UuidCreate。
使用 opcode = START、活動識別碼 = 產生的活動識別符，以及相關活動標識碼 = 父活動識別碼 (或 NULL，如果沒有父活動標識碼) 則為 NULL。
使用 opcode = INFO 寫入任意數目的活動資訊事件，活動識別碼 = 產生的活動識別碼。
使用 opcode = STOP 撰寫停止事件，活動識別碼 = 產生的活動識別碼。

追蹤譯碼工具接著能夠根據其活動標識碼，將這些事件組織成群組。

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	traceloggingprovider.h