winCE DEBUGZONE

对于实时系统，如何调试是一个很难解决的问题，包括对系统内核的调试，对驱动程序的调试，对应用程序的调试等。对于应用程序，通常各集成开发环境都提供了常规的单步跟踪等调试手段。而对于另两个的调试，Platform Builder除了为我们提供了常规的断点跟踪等手段以外，还和系统的源程序配合使用了一种新的调试手段——Debug Zones调试区。
通常，我们都是利用OutputDebugString函数来实现调试信息的输出的，但是由于系统底层的调试信息非常繁多，如果这样大量的调试信息用于实时输出的话一定会影响到系统的性能和实时性，也就影响到了系统的运行。如果有一种方式能允许开发人员自己选择输出哪些调试信息，不输出哪些调试信息的话，那么就可以让开发人员只看到关心的调试信息，而把诸如键盘按键、鼠标移动等无用的调试信息隐去，则可以更好的提高开发效率，迅速找到问题所在。
调试区就是为了解决以上提出的问题的，对某一个驱动程序，它规定好自己向外输出的调试信息的分类，比如初始化时的信息，出错时的信息，释放时的信息，激活时的信息等，然后分成几个调试区，在现有的CE版本中最多允许16个调试区。开发人员通过Platform Builder中Target菜单下的CE Debug Zones命令来决定想要得到哪一个或哪几个调试区的信息，在驱动程序中则可以根据开发人员的选择来输出指定调试区的信息。这就是调试区大体上的工作原理。
接下来，我们就来看一下调试区的定义，声明，注册及使用。
在程序中使用调试区之前必须先定义它们，一个程序的16个调试区编号分别为0-15。代码样例如下所示：
#ifdef DEBUG
//
// For debug builds, use the real zones.
//
#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) 

#else
//
// For retail builds, use forced messages based on the zones turned on below.
//
#define ZONE_TEST 0 
#define ZONE_PARAMS 0 
#define ZONE_VERBOSE 0
……
#define ZONE_WARN 0 
#define ZONE_ERROR 0

#endif

这样，就可以程序的DEBUG版本中使用调试区了，而在RELEASE版本中则将其全部定义为0，调试信息即不再输出。
在程序中，除了以上的定义以外，还要声明几个专用的调试信息输出函数，这些函数与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()

好了，调试区就概要的说了这么多，如此复杂的机制在自己的程序中写起来是烦琐了点，不过如果你需要的话，可以从CE现有的例程序中复制过来，这样就省了很多麻烦事，也不会出错。下图是在PB中使用调试区的截图，当选中某一个调试区后，如果该调试区有调试信息则会在DEBUG窗口输出。

 

转自：http://hi.baidu.com/zibbio/blog/item/18a8489adb0080b2c9eaf485.html