TraceLoggingOpcode 宏 (traceloggingprovider.h)
TraceLogging 包裝函式宏 ，可設定事件的 opcode。
語法
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 |