??????? 在定義了NewGPE類之后，我們需要實現一個實例，首先定義一個該類的指針：

??????????? static GPE??? *gGPE = (GPE*)NULL;

???????? 然后實現GetGPE函數，如下：

??? GPE *GetGPE(void)

??? {

??????? if (!gGPE)

??????? {

??????????? gGPE = new NewGPE();

??????? }

?

??????? return gGPE;

??? }

??????? 在該函數中，創建了一個NewGPE的實例。在這個時候NewGPE構造函數會被調用，一般我們會在這里面作一些與顯示相關的初始化的工作。該函數返回gGPE指針給上層接口。

???????? 3 實現DrvEnableDriver和DisplayInit函數

??????? Display驅動對上層的GWES模塊提供了20多個函數接口，但是這些函數并不是直接提供出來的，實際上只是通過一個DrvEnableDriver(..)函數來完成的。該函數在Display驅動的MDD層中沒有實現，所以需要在PDD層中定義，如下：

??????? BOOL APIENTRY DrvEnableDriver(ULONG engineVersion, ULONG cj, DRVENABLEDATA *data, PENGCALLBACKS? engineCallbacks)

{

????? BOOL fOk = FALSE;

?

????? // make sure we know where our registry configuration is

????? if(gszBaseInstance[0] != 0) {

??????????? fOk = GPEEnableDriver(engineVersion, cj, data, engineCallbacks);

????? }

?

????? return fOk;

}

?????? ?engineVersion：DDI版本號，目前為DDI_DRIVER_VERSION。

??????????? cj：DRVENABLEDATA結構的大小。

??????????? data：指向DRVENABLEDATA結構體。

engineCallbacks：指向一個回調函數結構體，傳入一些GDI函數到Display驅動中。

??????? 其中，DRVENABLEDATA結構中包含了Display驅動中的設備接口函數的指針，在DrvEnableDriver函數中調用了GPEEnableDriver函數，該函數會導出GWES模塊所需的所有Display驅動的接口函數。同時GWES模塊通過第四個參數engineCallbacks提供回調函數供Display驅動調用。該函數在”ddi_if”中定義。

??????? 另一個重要的函數是DisplayInit函數，它是第一個被執行的Display驅動中的函數，該函數主要用于讀取注冊表中的一些信息并作判斷。該函數是可選的，也可以不在驅動中實現它。

??????? BOOL APIENTRY DisplayInit(LPCTSTR pszInstance, DWORD dwNumMonitors)

{

????? DWORD dwStatus;

????? HKEY hkDisplay;

????? BOOL fOk = FALSE;

?

??? if(pszInstance != NULL) {

??????? _tcsncpy(gszBaseInstance, pszInstance, dim(gszBaseInstance));

??? }

?

????? // sanity check the path by making sure it exists

????? dwStatus = RegOpenKeyEx(HKEY_LOCAL_MACHINE, gszBaseInstance, 0, 0, &hkDisplay);

????? if(dwStatus == ERROR_SUCCESS) {

??????????? RegCloseKey(hkDisplay);

??????????? fOk = TRUE;

????? }

else

{

RETAILMSG(0, (_T("SALCD2: DisplayInit: can't open '%s'\r\n"), gszBaseInstance));

????? }

?

??? return fOk;

}

?

??????????? pszInstance：注冊表中顯示驅動的相關注冊表值

??????????? dwNumMonitors：支持的Monitor的個數

???????? 在該函數中主要通過讀取注冊表信息判斷顯示驅動的存在，如果返回錯誤，則GWES會停止Display驅動的初始化。當然，用戶可以根據自己的要求靈活掌握，也可以在這里初始化顯示設備或做其他的初始化工作。

???????? 4 實現GPE類中的函數

??????? 由于NewGPE繼承于GPE類，所以必須實現GPE類中的所有純虛函數，這些函數實際上就是PDD層驅動中需要實現的函數，如下：

???????? 4.1 virtual SCODE GetModeInfo(GPEMode *pMode, INT modeNumber)

??????????? 獲得顯示模式。

??????????????? pMode：輸出顯示模式結構

??????????????? modeNumber：顯示模式索引號

??????? 4.2 virtual int NumModes(void)

??????????? 獲得當前驅動支持的顯示模式的個數

??????? 4.3 virtual SCODE SetMode(INT modeId, HPALETTE *palette)

??????????? 設置顯示模式。

??????????????? modeId：顯示模式索引號

??????????????? palette：調色板指針，指向一個由EngCreatePalette函數創建的調色板

??????? 4.4 virtual SCODE AllocSurface(GPESurf **surface, INT width, INT height, EGPEFormat format, INT surfaceFlags)

??????????? 在系統內存中創建一個繪圖平面。

??????????????? surface：指向被分配的內存的指針

??????????????? width：寬度

??????????????? height：高度

??????????????? format：繪圖平面格式

??????????????? surfaceFlags：標記位，標明在哪分配內存

??????? 4.5 virtual SCODE SetPointerShape(GPESurf *pMask, GPESurf *pColorSurface, INT xHot, INT yHot, INT cX, INT cY);

??????????? 設置光標形狀。

??????????????? pMask：指向一個包含光標形狀的掩碼

??????????????? pColorSurface：指向被光標使用的顏色繪圖平面

??????????????? xHot：光標熱點的X坐標

??????????????? yHot：光標熱點的Y坐標

??????????????? cX：光標寬度

??????????????? cY：光標高度

??????? 4.6 virtual SCODE MovePointer(int x, int y)

??????????? 移動光標到指定位置或者隱藏光標

??????????????? x：光標移動位置的x坐標，若為-1表示隱藏光標。

??????????????? y：光標移動位置的y坐標

??????? 4.7 virtual SCODE BltPrepare(GPEBltParms *blitParameters)

??????????? 在做位塊傳輸前會先執行該函數，用于確定執行BLT的函數

??????????????? blitParameters：指向一個GPE的位塊傳輸參數的結構體

?????? 4.8 virtual SCODE BltComplete(GPEBltParms *blitParameters)

??????????? 該函數用于釋放在BltPrepare中申請的資源

??????????????? blitParameters：指向一個GPE的位塊傳輸參數的結構體

?????? 4.9 virtual SCODE Line(GPELineParms *lineParameters, EGPEPhase phase)

??????????? 畫線函數

??????????????? lineParameters：指向一個GPE的Line結構體，描述所畫的線

??????????????? phase：畫線所處的階段，具體描述如下

??????????????????????????????????? gpeSingle：畫單根線

??????????????????????????????????? gpePrepare：準備畫線

??????????????????????????????????? gpeContinue：畫線過程中

??????????????????????????????????? gpeComplete：畫線完成

???? ?? 在這里要提一點，有時我們會看到在該函數中調用另一個函數WrappedEmulatedLine(..)，這個函數在WinCE的PUBLIC目錄下的參考Display驅動中也可以找到，該函數是一個快速的畫線函數，里面采用了Bresenham畫線算法，通過采用運行速度快的加減和移位運算來完成畫線。

???????? 4.10 virtual SCODE SetPalette(const PALETTEENTRY *pSource, USHORT firstEntry, USHORT numEntries)

??????????? 設置調色板

??????????????? pSource：指向一個調色板入口信息的結構體

??????????????? firstEntry：第一個入口

??????????????? numEntries：入口的個數

?????? 4.11 virtual int InVBlank(void)

??????????? 顯示設備是否處于垂直消隱期間

??????? 上述函數在GPE類中均被定義為純虛函數，需要在繼承類中實現，也就是在我們的驅動程序中實現。這些函數是必須實現的。根據顯示的需求，還可以在顯示驅動中添加其他的函數，比如對光標的支持，對旋轉的支持等，如下：

??????? 4.12 void CursorOn(void)

??????????? 使能光標顯示。

?????? 4.13 void CursorOff(void)

??????????? 禁止光標顯示。

????? 4.14 void SetRotateParms(void)

??????????? 設置屏幕翻轉參數。

?????? 4.15 void DynRotate(int angel)

??????????? 支持動態翻轉。

??????????????? angel：翻轉角度

?????? 4.16 ULONG *APIENTRY DrvGetMasks(DHPDEV dhpdev)

??????????? 獲得顯示模式的RGB掩碼

??????????????? dhpdev：指向掩碼信息，比如RGB565模式為(0xf800，0x07e0，0x001f)

?????????? NOTE：該函數必須在驅動中被實現。

?????? 4.17 PowerHandler(BOOL bOff)

??????????? 電源控制。

??????????????? bOff：TRUE表示關閉電源，FALSE表示打開電源

??????? 4.18 ULONG DrvEscape(DHPDEV dhpdev, SURFOBJ* pso, ULONG iEsc, ULONG cjIn, PVOID pvIn, ULONG cjOut, PVOID pvOut)

??????? 該函數提供給應用程序的一個直接訪問顯示驅動的接口，和流設備驅動中的IoCtls函數類似。應用程序通過調用ExtEscape函數傳送操作碼和數據給顯示設備驅動，DrvEscape函數會接收到數據并進行處理，然后返回相應結果給EstEscape函數。用戶也可以根據需要自己定義相應的操作碼。

??????????????? dhpdev：設備句柄

??????????????? pso：指向一個繪圖平面的結構

??????????????? iEsc：操作碼

??????????????? cjIn：輸入數據buffer的大小

??????????????? pvIn：指向輸入數據buffer

??????????????? cjOut：輸出數據buffer的大小

??????????????? pvOut：指向輸出數據buffer

???????