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 架構慣例會使用最多四個字節的鏈結,將卷標編碼為 28 位位元段,其中最多使用最多四個字節,且最上層位會做為『chain』 位元, (4 個字節 * 每個位元組 7 個可用位 = 28 位) 。 數據會先編碼最重要的位元組。 在 C 中, TraceLoggingWrite 限制為標記的 2 位元組編碼,因此標記的低 14 位必須是 0。
如果未為事件提供 TraceLoggingEventTag 參數,則事件不會傳輸任何標記,而且事件會有 0 的標記。 如果提供多個 TraceLoggingEventTag 參數,標籤值會一起或一起。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | traceloggingprovider.h |