TraceLoggingKeyword 宏 (traceloggingprovider.h)
用于设置事件关键字 (keyword) 的 TraceLogging 包装器宏。
语法
void TraceLoggingKeyword(
[in] eventKeyword
);
参数
[in] eventKeyword
一个 64 位位掩码，用于指示事件在一组事件类别中的成员身份。 此值必须是编译时常量。
重要
ProviderId、Level 和 Keyword 是筛选事件的主要方式。 可以进行其他类型的筛选，但开销要高得多。 始终为每个事件分配有意义的非零级别和关键字 (keyword) 。
有关事件关键字 (keyword) 的详细信息，请参阅EVENT_DESCRIPTOR。
返回值
无
备注
TraceLoggingKeyword(eventKeyword)可用作 TraceLoggingWrite 宏调用的参数，以设置事件的关键字 (keyword) 。 事件关键字 (keyword) 是筛选事件的主要方法。 始终为每个事件分配有意义的 (非零) 关键字 (keyword) 。
如果未向 TraceLoggingWrite 调用提供 TraceLoggingKeyword 宏，则事件的默认关键字 (keyword) 为 0。 如果提供了多个 TraceLoggingKeyword 宏，则值将 OR 组合在一起。
关键字 (keyword) (位掩码0xFFFF000000000000) 的前 16 位由 Microsoft 定义。 关键字 (keyword) (位掩码0x0000FFFFFFFFFFFF) 的低 48 位由事件提供程序定义。 例如，事件提供程序可以将位 0 (位掩码0x1) 定义为“I/O”类别，将位 1 (位掩码 0x2) 定义为“UI”类别，将位 2 (位掩码0x4) 定义为“性能度量”类别。 在这种情况下，事件关键字 (keyword) 可能设置为0x5，表示事件同时处于“I/O”和“性能度量”类别。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | traceloggingprovider.h |