如何在 C/C++ 宏中包含跟踪语句？

严格地说，宏中不能有 trace 语句，因为 WPP 预处理器在 C 预处理器之前运行。 一种解决方法是运行 C 预处理器两次，但有一个更简单的解决方案：在跟踪宏中定义可选的前置和后步骤。

例如，你可能需要 "失败时退出" 宏，如

If (FAILED(HR)) {
     DoTraceMessage(ERROR,"We failed!");
     Goto done ;
} 

在这种情况下，使用宏的 PRE 和 POST 形式可以实现此功能。

定义函数

在源文件中，定义函数，例如：

FUNC:_EXIT_IF_EXP_FAILED{LEVEL=WSM_ERROR}(_EXIT_IF_EXP_FAILED_EXP,MSG,...)

定义宏

在标头文件中，添加以下定义指令。 将其放在 WPP_CONTROL_GUIDS 定义之后和跟踪消息头文件的#include语句前面。

#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_PRE(LEVEL, HR) {HRESULT hr=S_OK ; if(FAILED(hr = HR)) {
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_POST(LEVEL, HR) ; goto done; } }
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_ENABLED(LEVEL, HR) WPP_LEVEL_ENABLED(LEVEL)
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_LOGGER(LEVEL, HR) WPP_LEVEL_LOGGER(WSM_ERROR)

添加格式

可以通过在标头文件中包含格式设置数据来使跟踪消息更易于读取。 此步骤是可选的。

// MACRO: _EXIT_IF_EXP_FAILED
//
// begin_wpp config
// USEPREFIX (_EXIT_IF_EXP_FAILED,"%!STDPREFIX!");
// FUNC _EXIT_IF_EXP_FAILED{LEVEL=WSM_ERROR}(_EXIT_IF_EXP_FAILED_EXP,MSG,...);
// USESUFFIX (_EXIT_IF_EXP_FAILED," hr= %!HRESULT!", hr);
// end_wpp
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_PRE(LEVEL, HR) {HRESULT hr=S_OK ; if(FAILED(hr = HR)) {
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_POST(LEVEL, HR) ; goto done; } }
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_ENABLED(TRACELEVEL, HR) WPP_LEVEL_ENABLED(TRACELEVEL)
#define WPP_LEVEL__EXIT_IF_EXP_FAILED_EXP_LOGGER(LEVEL, HR) WPP_LEVEL_LOGGER(WSM_ERROR)

在此示例中， begin_wpp config 和 end_wpp 语句标识用于 wpp 的标头文件中的配置数据。

此外，若要通知 WPP 在标头文件中存在配置数据，请将 -scan 参数添加到调用 WPP 预处理器的 RUN_WPP 宏。 例如：

RUN_WPP -scan:trace.h

有关 RUN_WPP 的可选参数的完整列表，请参阅 WPP 预处理器。

使用宏

在源代码中，使用宏，如以下调用中的：

_EXIT_IF_EXP_FAILED(hr,"it failed");