允許開發人員自己選擇輸出哪些調試信息,不輸出哪些調試信息的話,那麼就可以讓開發人員只看到關心的調試信息,而把諸如鍵盤按鍵、鼠標移動等無用的調試信息隱去,則可以更好的提高開發效率,迅速找到問題所在。
對某一個驅動程序,它規定好自己向外輸出的調試信息的分類,比如初始化時的信息,出錯時的信息,釋放時的信息,激活時的信息等,然後分成幾個調試區,在現有的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()