如何在 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 configend_wpp 语句标识用于 wpp 的标头文件中的配置数据。

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

RUN_WPP -scan:trace.h

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

使用宏

在源代码中,使用宏,如以下调用中的:

_EXIT_IF_EXP_FAILED(hr,"it failed");