Windows CE调试区的使用

允许开发人员自己选择输出哪些调试信息，不输出哪些调试信息的话，那么就可以让开发人员只看到关心的调试信息，而把诸如键盘按键、鼠标移动等无用的调试信息隐去，则可以更好的提高开发效率，迅速找到问题所在。

    对某一个驱动程序，它规定好自己向外输出的调试信息的分类，比如初始化时的信息，出错时的信息，释放时的信息，激活时的信息等，然后分成几个调试区，在现有的CE版本中最多允许16个调试区。开发人员通过Platform. Builder中Target菜单下的CE Debug Zones命令(在Target菜单下)来决定想要得到哪一个或哪几个调试区的信息，在驱动程序中则可以根据开发人员的选择来输出指定调试区的信息。这就是调试区大体上的工作原理。

#define ZONE_TEST DEBUGZONE(0)
#define ZONE_PARAMS DEBUGZONE(1)
#define ZONE_VERBOSE DEBUGZONE(2)
……
#define ZONE_WARN DEBUGZONE(14)
#define ZONE_ERROR DEBUGZONE(15)

 

在程序中，除了以上的定义以外，还要声明几个专用的调试信息输出函数，这些函数与OutputDebugString函数的区别就在于在调用时需要指定对应的调试区，这些函数以及以上用到的DEBUGZONE宏的定义都在DbgApi.h头文件中，因此只要在源程序中包含此头文件即可。除此以外，还需要一个全局的DEBPARAM类型的变量命名为dpCurSettings，以供集成开发环境和调试信息输出函数使用。其代码样例如下：
#ifdef DEBUG
DBGPARAM dpCurSettings = {
   TEXT("WaveDriver"), {
   TEXT("Test") // 0
   ,TEXT("Params") // 1
   ,TEXT("Verbose") // 2
   ,TEXT("Interrupt") // 3
   ,TEXT("WODM") // 4
   ,TEXT("WIDM") // 5
   ,TEXT("PDD") // 6
   ,TEXT("MDD") // 7
   ,TEXT("Regs") // 8
   ,TEXT("Misc") // 9
   ,TEXT("Init") // 10
   ,TEXT("IOcontrol") // 11
   ,TEXT("Alloc") // 12
   ,TEXT("Function") // 13
   ,TEXT("Warning") // 14
   ,TEXT("Error") // 15
  }
  ,
  (1 << 15) // Errors
  | (1 << 14) // Warnings
};
#endif
    此例中还把ERROR和WARN调试区作为默认被开发人员选中的调试区。
    要想使用调试区，还需要做的最后一件准备的事情就是在程序中进行注册，也就是在程序启动时通知集成开发环境本程序中要使用调试区，这个注册很简单，只要在程序的入口处使用DEBUGREGISTER宏即可，样例如下：
DllEntry (
HANDLE hinstDLL,
DWORD Op,
LPVOID lpvReserved
)
{
switch (Op) {

case DLL_PROCESS_ATTACH :
DEBUGREGISTER((HINSTANCE)hinstDLL);
break;
……
    至于调试区的使用，完全是几个宏的使用而已，我想做程序的人都会用的，常用的宏如下：
DEBUGMSG(),DEBUGLED(),RETAILMSG(),RETAILLED(),ERRORMSG(),DEBUGCHK()

 

原文地址：http://space.itpub.net/16803921/viewspace-515904