-- 作者：wangxinxin
-- 發布時間：2010-11-26 11:16:35
-- wince驅動開發3
6、驅動中注意的要點
1：CE下同名設備不能大于10
CE5.0中已經沒有這個問題了，以前的版本可以這樣做：只給上層輸出一個設備，然后用一個IOCTL去打開一個個的物理設備這樣就可以做到不受任何限制了。
2：MDD與PDD
一個驅動程序通常會被分成硬件相關（PDD）與硬件無關（MDD）層兩部分。
當然，這種分層不是必須的，只是采用這種分層以后可以少寫很多代碼，因為微軟提供了很多驅動程序的MDD。即使CE中沒有我們所寫的驅動程序的樣例，采用這種結構以后，當需要寫第二個程序時，就可以重用它的代碼,就可以提高開發效率。
MDD是提供同類型的設備（比如串口）都會有的功能，這樣PDD基本上就只有寄存器操作了。
像串口的中斷處理，Read/Write函數，其大部分代碼都是在MDD中實現的，不同的串口實現中只需要提供一些實際操作寄存器的函數。不同的驅動程序，其MDD與PDD的接口不盡相同，
3：XXX_Init函數的返回句柄
通常，這個句柄是驅動程序自己保存數據的一個指針，我們在Init返回時告訴上層程序，以后上層調用其它函數（例如Open）時，會將這個值傳入，這樣，我們就可以訪問自己的一些私有數據。
當然，也可以返回一個任意的非0值對于一個設備驅動程序，系統不用的層會有不同的句柄。我們在XXX＿Init中返回的句柄保存在設備管理器中，別的程序中應該是看不到的，而用CreateFile也會得到一個文件句柄，這個保存在哪我不知道，但和前者是不一樣的。也就是說不同層的軟件所關心的句柄也會不一樣
4：DEBUGMSG與RETAILMSG的區別
它們都是輸出調試信息用的，區別是：
DEBUGMSG只在DEBUG版中有效，RELEASE版中它被定義成了NULL
RETAILMSG在DEBUG和RELEASE版中都可以輸出，
而且DEBUGMSG可以在運行時刻用DEBUZONE控制要不要輸出信息。
在ship build 時，RETAILMSG 和DEBUGMSG都無效。
5：調試區與dpCurSettings
我們都是利用OutpubDebugString函數來實現調試信息的輸出的，但是由于系統底層的調試信息非常繁多，如果這樣大量的調試信息用于實時輸出的話一定會影響到系統的性能和實時性，也就影響到了系統的運行。如果有一種方式能允許開發人員自己選擇輸出哪些調試信息，不輸出哪些調試信息的話，那么就可以讓開發人員只看到關心的調試信息，而把諸如鍵盤按鍵、鼠標移動等無用的調試信息隱去，則可以更好的提高開發效率。
調試區就是為了解決以上提出的問題的，對某一個驅動程序，它規定好自己向外輸出的調試信息的分類，比如初始化時的信息，出錯時的信息，釋放時的信息，激活時的信息等，然后分成幾個調試區，在現有的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;
……
|