TraceLoggingKeyword 宏 (traceloggingprovider.h)

TraceLogging 包裝函式宏 ，可設定事件的 關鍵詞。

語法

void TraceLoggingKeyword(
  [in]  eventKeyword
);

參數

[in] eventKeyword

64 位位掩碼，用來指出事件類別集合中的事件成員資格。 此值必須是編譯時間常數。

重要

ProviderId、Level 和 Keyword 是篩選事件的主要方法。 其他類型的篩選是可行的，但額外負荷較高。 一律將有意義的非零層級和關鍵詞指派給每個事件。

如需事件關鍵詞的詳細資訊 ，請參閱EVENT_DESCRIPTOR 。

傳回值

無

備註

TraceLoggingKeyword(eventKeyword) 可用來做為 TraceLoggingWrite 宏調用的參數，以設定事件的關鍵詞。 Event 關鍵詞是篩選事件的主要方法。 請一律將有意義的 (非零) 關鍵詞指派給每個事件。

如果未將 TraceLoggingKeyword 宏提供給 TraceLoggingWrite 呼叫，則事件的默認關鍵詞為 0。 如果提供多個 TraceLoggingKeyword 宏，這些值會一起或一起處理。

Microsoft 會定義關鍵詞的前 16 位 (位掩碼0xFFFF000000000000) 。 事件提供者會定義關鍵詞的低 48 位 (位掩碼0x0000FFFFFFFFFFFF) 。 例如，事件提供者可能會定義位0 (位掩碼0x1) 为 “I/O” 類別，位1 (位掩碼0x2) 为 “UI” 類別，而位2 (位掩碼0x4) 为「效能測量」類別。 在此案例中，事件可能會將其關鍵詞設定為0x5，指出事件同時位於「I/O」和「效能測量」類別中。

規格需求

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

另請參閱

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging 包裝函式宏