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

另請參閱

TraceLoggingWrite

TraceLogging 包裝函式宏

TRACE_EVENT_INFO