WinCE Display驅動(dòng)開(kāi)發(fā)介紹

2 實(shí)現GetGPE函數

在定義了NewGPE類(lèi)之后，我們需要實(shí)現一個(gè)實(shí)例，首先定義一個(gè)該類(lèi)的指針：

static GPE *gGPE = (GPE*)NULL;

然后實(shí)現GetGPE函數，如下：

GPE *GetGPE(void)

{

if (!gGPE)

{

gGPE = new NewGPE();

}

return gGPE;

}

在該函數中，創(chuàng )建了一個(gè)NewGPE的實(shí)例。在這個(gè)時(shí)候NewGPE構造函數會(huì )被調用，一般我們會(huì )在這里面作一些與顯示相關(guān)的初始化的工作。該函數返回gGPE指針給上層接口。

3 實(shí)現DrvEnableDriver和DisplayInit函數

Display驅動(dòng)對上層的GWES模塊提供了20多個(gè)函數接口，但是這些函數并不是直接提供出來(lái)的，實(shí)際上只是通過(guò)一個(gè)DrvEnableDriver(..)函數來(lái)完成的。該函數在Display驅動(dòng)的MDD層中沒(méi)有實(shí)現，所以需要在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：指向一個(gè)回調函數結構體，傳入一些GDI函數到Display驅動(dòng)中。

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

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

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'rn), gszBaseInstance));

}

return fOk;

}

pszInstance：注冊表中顯示驅動(dòng)的相關(guān)注冊表值

dwNumMonitors：支持的Monitor的個(gè)數

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

4 實(shí)現GPE類(lèi)中的函數

由于NewGPE繼承于GPE類(lèi)，所以必須實(shí)現GPE類(lèi)中的所有純虛函數，這些函數實(shí)際上就是PDD層驅動(dòng)中需要實(shí)現的函數，如下：

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

獲得顯示模式。

pMode：輸出顯示模式結構

modeNumber：顯示模式索引號

4.2 virtual int NumModes(void)

獲得當前驅動(dòng)支持的顯示模式的個(gè)數

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

設置顯示模式。

modeId：顯示模式索引號

palette：調色板指針，指向一個(gè)由EngCreatePalette函數創(chuàng )建的調色板

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

在系統內存中創(chuàng )建一個(gè)繪圖平面。

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

width：寬度

height：高度

format：繪圖平面格式

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

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

設置光標形狀。

pMask：指向一個(gè)包含光標形狀的掩碼

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

xHot：光標熱點(diǎn)的X坐標

yHot：光標熱點(diǎn)的Y坐標

cX：光標寬度

cY：光標高度

4.6 virtual SCODE MovePointer(int x, int y)

移動(dòng)光標到指定位置或者隱藏光標

x：光標移動(dòng)位置的x坐標，若為-1表示隱藏光標。

y：光標移動(dòng)位置的y坐標

4.7 virtual SCODE BltPrepare(GPEBltParms *blitParameters)

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

blitParameters：指向一個(gè)GPE的位塊傳輸參數的結構體

4.8 virtual SCODE BltComplete(GPEBltParms *blitParameters)

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

blitParameters：指向一個(gè)GPE的位塊傳輸參數的結構體

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

畫(huà)線(xiàn)函數

lineParameters：指向一個(gè)GPE的Line結構體，描述所畫(huà)的線(xiàn)

phase：畫(huà)線(xiàn)所處的階段，具體描述如下

gpeSingle：畫(huà)單根線(xiàn)

gpePrepare：準備畫(huà)線(xiàn)

gpeContinue：畫(huà)線(xiàn)過(guò)程中

gpeComplete：畫(huà)線(xiàn)完成

在這里要提一點(diǎn)，有時(shí)我們會(huì )看到在該函數中調用另一個(gè)函數WrappedEmulatedLine(..)，這個(gè)函數在WinCE的PUBLIC目錄下的參考Display驅動(dòng)中也可以找到，該函數是一個(gè)快速的畫(huà)線(xiàn)函數，里面采用了Bresenham畫(huà)線(xiàn)算法，通過(guò)采用運行速度快的加減和移位運算來(lái)完成畫(huà)線(xiàn)。

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

設置調色板

pSource：指向一個(gè)調色板入口信息的結構體

firstEntry：第一個(gè)入口

numEntries：入口的個(gè)數

4.11 virtual int InVBlank(void)

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

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

4.12 void CursorOn(void)

使能光標顯示。

4.13 void CursorOff(void)

禁止光標顯示。

4.14 void SetRotateParms(void)

設置屏幕翻轉參數。

4.15 void DynRotate(int angel)

支持動(dòng)態(tài)翻轉。

angel：翻轉角度

4.16 ULONG *APIENTRY DrvGetMasks(DHPDEV dhpdev)

獲得顯示模式的RGB掩碼

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

NOTE：該函數必須在驅動(dòng)中被實(shí)現。

4.17 PowerHandler(BOOL bOff)

電源控制。

bOff：TRUE表示關(guān)閉電源，FALSE表示打開(kāi)電源

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

該函數提供給應用程序的一個(gè)直接訪(fǎng)問(wèn)顯示驅動(dòng)的接口，和流設備驅動(dòng)中的IoCtls函數類(lèi)似。應用程序通過(guò)調用ExtEscape函數傳送操作碼和數據給顯示設備驅動(dòng)，DrvEscape函數會(huì )接收到數據并進(jìn)行處理，然后返回相應結果給EstEscape函數。用戶(hù)也可以根據需要自己定義相應的操作碼。

dhpdev：設備句柄

pso：指向一個(gè)繪圖平面的結構

iEsc：操作碼

cjIn：輸入數據buffer的大小

pvIn：指向輸入數據buffer

cjOut：輸出數據buffer的大小

pvOut：指向輸出數據buffer