Windows CE 6.0下dpCurSettings編譯出錯及解決辦法

今天在編譯6410的鏡像檔案的時候，突然報錯：

BUILD: [01:0000004569:ERRORE] iic_mdd.obj : error LNK2001: unresolved external symbol dpCurSettings
BUILD: [01:0000004570:ERRORE] D:\WINCE600\platform\SMDK6410\target\ARMV4I\debug\s3c6410_iic.dll : fatal error LNK1120: 1 unresolved externals
BUILD: [01:0000004571:INFO  ]     editbin /nxcompat D:\WINCE600\platform\SMDK6410\target\ARMV4I\debug\s3c6410_iic.dll
BUILD: [01:0000004572:INFO  ] Microsoft (R) COFF/PE Editor Version 8.00.50727.42
BUILD: [01:0000004573:INFO  ] Copyright (C) Microsoft Corporation.  All rights reserved.
BUILD: [01:0000004574:INFO  ]
BUILD: [01:0000004575:INFO  ] EDITBIN : fatal error LNK1104: cannot open file 'D:\WINCE600\platform\SMDK6410\target\ARMV4I\debug\s3c6410_iic.dll' 

什麼原因？難道我的BSP被我修改了太多次，或者無意中修改了什麼檔案？可是我沒有動過IIC下的代碼呀？最怕就是我修改了環境變數就慘了...抱著一顆嘗試的心，我又換了之前備份的SMDK6410的BSP包，可是編譯的結果一樣！錯誤仍然在繼續？怎麼解決？

先按照 字面意思找到IIC下面的的所有代碼，搜尋dpCurSettings，但是居然沒有這個變數，費解...還準備找到相應代碼，external一下呢，看樣子這個方法不靠譜了。

繼續在整個WINCE600下面搜尋，結果出現一堆，按照時間先後順序排列一下，還是有幾十個（這幾十個只是涉及SMDK6410的，還有PUBLIC下面的許多未計算在內）... 看了兩個，惰性來了，準備到CSDN論壇上發帖求助，剛打好了兩個字，算了還是先GOOGLE吧，結果出現幾個文章，原來還是有朋友和我遇見類似的問題，按照hzdysymbol兄的幫忙，解決了這個問題。

原話是這樣的：你編譯的是Debug版的,換成Release就應該可以解決這個問題. 試試吧

很穩！感謝 hzdysymbol！這個問題已經解決！

探求 dpCurSettings到底是個啥子？

找到唐勉老師的部落格：http://space.itpub.net/16912323/viewspace-509778，引用如下：

在WinCE的開發環境中支援Debug Zones功能，通常也被稱為調試域，通過它可以控制列印資訊。當某個調試域被開啟以後， 在這個域中的列印資訊就會被列印出來，如果某個調試域被關閉了，那麼這個域中的列印資訊就會被關閉。調試域是基於模組的，也就是說一個模組，可能是在一個 驅動或者一個應用中都可以定義一個調試域，用來調試該模組。一個調試域最多可以包括16個域，一般在每一個模組中都會有一個全域變數dpCurSettings，該變數用於描述調試域的相關信 息，它由一個模組名字，16個域的名字和一個掩碼組成。下面具個 例子：

DBGPARAM dpCurSettings =

{
    TEXT("PCIBUS"), {
    TEXT("Errors"),TEXT("Warnings"),TEXT("Functions"),TEXT("Initialization"),
    TEXT("Enumeration"),TEXT("Load Order"),TEXT("Resource"),TEXT("Undefined"),
    TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined"),
    TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined"),TEXT("Undefined") },
    0x20

};

先來解釋一下DBGPARAM結構，該結構在Dbgapi.h中定義，所以在定義dpCurSettings的時候還需要包含這個標頭檔，該結 構定義如下：

typedef struct _DBGPARAM {

    WCHAR  lpszName[32];                    //模組的名字

    WCHAR  rglpszZones[16][32];            //調試域的名字

    ULONG  ulZoneMask;                        //調試域的掩碼

}DBGPARAM, *LPDBGPARAM;

 

在上面的例子中可以看到，第一個是模 塊的名字，叫PCIBUS。而後定義了16個域的名字，其中只用到了7個域，剩下的都定義為Undefined了。最後一個數字為域的掩碼，表示當前哪個域是被啟用的，0x20表示只有第6個域是被啟用的。從上面的例子還可以 看出，前7個域是有意義的，而且按照順序分別對 應1到7。下面針對這些域需要定義相應Debug調試的宏定義：

#define DBGZONE_ERROR                           1

#define DBGZONE_WARNING                     2

#define DBGZONE_FUNCTION                    3

#define DBGZONE_INIT                                4

#define DBGZONE_ENUM                            5

#define DBGZONE_LOADORDER                6

#define DBGZONE_RESOURCE                    7

 

上述宏定義對應在dpCurSettings中的7個域，然後就可以在列印資訊的時候，通過這些宏定義來對應相應的調試域了。例如：

1. while(1)
2. {
3.     if (dwFlag)
4.     {
5.          DEBUGMSG(DBGZONE_ERROR, (L"Error found: %d\r\n", NumDevKeys));
6.          break;
7.      }
8.      else
9.      {
10.          DEBUGMSG(DBGZONE_WARNING, (L"Warning found\r\n"));
11.      }
13.      DEBUGMSG(DBGZONE_LOADORDER, (L"load in a while loop\r\n"));
14.      Sleep(100);
15. }

 

從這段代碼可以看出，如果dpCurSettings中的掩碼定義為0x20，那麼在DEBUGMSG的列印中，只有條件為DBGZONE_LOADORDER才會被列印，迴圈中的前兩個列印資訊 是不會被列印的。如果想讓上面的代碼中的所有DEBUGMSG都能列印必須設定掩碼如下：

dpCurSettings.ulZoneMask = DBGZONE_ERROR | DBGZONE_WARNING | DBGZONE_LOADORDER;

 

在一個模組中定義了調試域，如果想 在系統中去使用還必須註冊該調試域，需要用到的函數叫DEBUGREGISTER(..)，其中要把該調試模組的控制代碼作為參 數傳給它。例如：

DllMain(..)

{

    switch(op)

    {

        case DLL_PROCESS_ATTACH:

            DEBUGREGISTER(hPCIBUS);

            break;

        ….

    }

}

完成了上述工作以後，就可以重新編譯調試的模組，然後運行系統來調試了。調試域的一個好處就是在Debug的過程中，不需要終止系統可以動態 的改變調試域，方便我們分析問題。首先，我們可以基於Platform. Builder中的CE Debug Zones來調試，在VS2005的菜單中選擇Target，然後選擇CE Debug Zones，

 圖片複製不過來，大家想瞭解就去看唐老師的部落格吧！

然後會出現一個Debug Zones的視窗，在視窗彈出以後，它可能會花 一點時間來收集當前支援Debug Zone的模組，如：

 

該圖只是一個例子，左邊顯示了可調試 的模組，選擇serial_SMDK2410.dll這個模組，就是S3C2410的串口驅動模組。在右側可以看到各 個調試域及名字，使用者可以根據需要來選擇開啟和關閉相應的調試域，最後點擊Apply和OK就可以了。

 

當然，還有其他的方法來修改調試域， 一種方法是使用Target Control中的zo命令來修改，Target Control將在以後介紹。還有一種方法就是通過SetDbgZone(..)函數來修改。定義如下：

BOOL SetDbgZone(DWORDdwProcid, LPVOIDlpvMod, LPVOIDbaseptr, DWORDzone, LPDBGPARAMlpdbgTgt)

    dwProcid：    進程的控制代碼

    lpvMod：        調試模組的控制代碼

    baseptr：        設定為NULL

    zone：            新的調試域掩碼

    lpdbgTgt：      返回新的DBGPARAM結構

 

上面對Debug Zone的定義，使用以及調試作了大致的介紹，按 照上面的步驟可以給一個模組添加調試域，註冊調試域並在系統運行以後隨時更改調試域，其根本目的無非是協助我們來調試模組和分析問題。一般情況下，調試域 只在Debug模式下使用，但是也可以在Release模式下使用。但是有些地方需要修改，首先前面已經介紹過Debug模式下的列印用DEBUGMSG，而Release模式下的列印應該使用RETAILMSG函數。所以在Release模式下，列印函數應該改為RETAILMSG函數。還有在註冊調試域的時候，不能再使 用DEBUGREGISTER(..)函數，而是應該改用RETAILREGISTERZONES(..)函數。