基于GWES的WinCE Display驅(qū)動開發(fā)介紹

void CursorOn(void);

void CursorOff(void);

#ifdef ROTATE

void SetRotateParms();

LONG DynRotate(int angle);

#endif

};

類NewGPE從GPE類上面繼承，其中包括一些屬性，如下：

m_ModeInfo：顯示模式，結(jié)構(gòu)如下

struct GPEMode {

int modeId; //開發(fā)者定義的顯示模式的索引號

int width; //顯示寬度

int height; //顯示高度

int Bpp; //顯示深度

int frequency; //顯示頻率

EGPEFormat format; // RGB格式，各占多少bit

};

m_colorDepth：顯示深度

m_VirtualFrameBuffer：FrameBuffer的地址

m_FrameBufferSize：FrameBuffer的大小

m_CursorDisabled：光標(biāo)使能標(biāo)記

m_CursorVisible：光標(biāo)可視標(biāo)記

用戶可以根據(jù)需要定義相應(yīng)的屬性，在NewGPE類中，需要定義并實現(xiàn)基類中的純虛函數(shù)，上面的NewGPE類中已經(jīng)包含了這些函數(shù)的定義，還包括了其他一些函數(shù)，將在下面介紹。

2.2 實現(xiàn)GetGPE函數(shù)

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

static GPE *gGPE = (GPE*)NULL;

然后實現(xiàn)GetGPE函數(shù)，如下：

GPE *GetGPE(void)

{

if (!gGPE)

{

gGPE = new NewGPE();

}

return gGPE;

}

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

2.3 實現(xiàn)DrvEnableDriver和DisplayInit函數(shù)

Display驅(qū)動對上層的GWES模塊提供了20多個函數(shù)接口，但是這些函數(shù)并不是直接提供出來的，實際上只是通過一個DrvEnableDriver()函數(shù)來完成的。該函數(shù)在Display驅(qū)動的MDD層中沒有實現(xiàn)，所以需要在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結(jié)構(gòu)的大小。

data：指向DRVENABLEDATA結(jié)構(gòu)體。

engineCallbacks：指向一個回調(diào)函數(shù)結(jié)構(gòu)體，傳入一些GDI函數(shù)到Display驅(qū)動中。

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

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

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：注冊表中顯示驅(qū)動的相關(guān)注冊表值

dwNumMonitors：支持的Monitor的個數(shù)

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

2.4 實現(xiàn)GPE類中的函數(shù)

由于NewGPE繼承于GPE類，所以必須實現(xiàn)GPE類中的所有純虛函數(shù)，這些函數(shù)實際上就是PDD層驅(qū)動中需要實現(xiàn)的函數(shù)，如下：

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

獲得顯示模式。

pMode：輸出顯示模式結(jié)構(gòu)

modeNumber：顯示模式索引號

2.4.2 virtual int NumModes(void)

獲得當(dāng)前驅(qū)動支持的顯示模式的個數(shù)

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

設(shè)置顯示模式。

modeId：顯示模式索引號

palette：調(diào)色板指針，指向一個由EngCreatePalette函數(shù)創(chuàng)建的調(diào)色板

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

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

surface：指向被分配的內(nèi)存的指針

width：寬度

height：高度

format：繪圖平面格式

surfaceFlags：標(biāo)記位，標(biāo)明在哪分配內(nèi)存

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

設(shè)置光標(biāo)形狀。

pMask：指向一個包含光標(biāo)形狀的掩碼

pColorSurface：指向被光標(biāo)使用的顏色繪圖平面

xHot：光標(biāo)熱點的X坐標(biāo)

yHot：光標(biāo)熱點的Y坐標(biāo)

cX：光標(biāo)寬度

cY：光標(biāo)高度

2.4.6 virtual SCODE MovePointer(int x, int y)

移動光標(biāo)到指定位置或者隱藏光標(biāo)

x：光標(biāo)移動位置的x坐標(biāo)，若為-1表示隱藏光標(biāo)。