基于GWES的WinCE Display驅(qū)動(dòng)開(kāi)發(fā)介紹
加入技術(shù)交流群
void CursorOn(void);
void CursorOff(void);
#ifdef ROTATE
void SetRotateParms();
LONG DynRotate(int angle);
#endif
};
類(lèi)NewGPE從GPE類(lèi)上面繼承，其中包括一些屬性，如下：
m_ModeInfo：顯示模式，結(jié)構(gòu)如下
struct GPEMode {
int modeId; //開(kāi)發(fā)者定義的顯示模式的索引號(hào)
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類(lèi)中，需要定義并實(shí)現(xiàn)基類(lèi)中的純虛函數(shù)，上面的NewGPE類(lèi)中已經(jīng)包含了這些函數(shù)的定義，還包括了其他一些函數(shù)，將在下面介紹。
2.2 實(shí)現(xiàn)GetGPE函數(shù)
在定義了NewGPE類(lèi)之后，我們需要實(shí)現(xiàn)一個(gè)實(shí)例，首先定義一個(gè)該類(lèi)的指針：
static GPE *gGPE = (GPE*)NULL;
然后實(shí)現(xiàn)GetGPE函數(shù)，如下：
GPE *GetGPE(void)
{
if (!gGPE)
{
gGPE = new NewGPE();
}
return gGPE;
}
在該函數(shù)中，創(chuàng)建了一個(gè)NewGPE的實(shí)例。在這個(gè)時(shí)候NewGPE構(gòu)造函數(shù)會(huì)被調(diào)用，一般我們會(huì)在這里面作一些與顯示相關(guān)的初始化的工作。該函數(shù)返回gGPE指針給上層接口。
2.3 實(shí)現(xiàn)DrvEnableDriver和DisplayInit函數(shù)
Display驅(qū)動(dòng)對(duì)上層的GWES模塊提供了20多個(gè)函數(shù)接口，但是這些函數(shù)并不是直接提供出來(lái)的，實(shí)際上只是通過(guò)一個(gè)DrvEnableDriver()函數(shù)來(lái)完成的。該函數(shù)在Display驅(qū)動(dòng)的MDD層中沒(méi)有實(shí)現(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版本號(hào)，目前為DDI_DRIVER_VERSION。
cj：DRVENABLEDATA結(jié)構(gòu)的大小。
data：指向DRVENABLEDATA結(jié)構(gòu)體。
engineCallbacks：指向一個(gè)回調(diào)函數(shù)結(jié)構(gòu)體，傳入一些GDI函數(shù)到Display驅(qū)動(dòng)中。
其中，DRVENABLEDATA結(jié)構(gòu)中包含了Display驅(qū)動(dòng)中的設(shè)備接口函數(shù)的指針，在DrvEnableDriver函數(shù)中調(diào)用了GPEEnableDriver函數(shù)，該函數(shù)會(huì)導(dǎo)出GWES模塊所需的所有Display驅(qū)動(dòng)的接口函數(shù)。同時(shí)GWES模塊通過(guò)第四個(gè)參數(shù)engineCallbacks提供回調(diào)函數(shù)供Display驅(qū)動(dòng)調(diào)用。該函數(shù)在”ddi_if”中定義。
另一個(gè)重要的函數(shù)是DisplayInit函數(shù)，它是第一個(gè)被執(zhí)行的Display驅(qū)動(dòng)中的函數(shù)，該函數(shù)主要用于讀取注冊(cè)表中的一些信息并作判斷。該函數(shù)是可選的，也可以不在驅(qū)動(dòng)中實(shí)現(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：注冊(cè)表中顯示驅(qū)動(dòng)的相關(guān)注冊(cè)表值
dwNumMonitors：支持的Monitor的個(gè)數(shù)
在該函數(shù)中主要通過(guò)讀取注冊(cè)表信息判斷顯示驅(qū)動(dòng)的存在，如果返回錯(cuò)誤，則GWES會(huì)停止Display驅(qū)動(dòng)的初始化。當(dāng)然，用戶可以根據(jù)自己的要求靈活掌握，也可以在這里初始化顯示設(shè)備或做其他的初始化工作。
2.4 實(shí)現(xiàn)GPE類(lèi)中的函數(shù)
由于NewGPE繼承于GPE類(lèi)，所以必須實(shí)現(xiàn)GPE類(lèi)中的所有純虛函數(shù)，這些函數(shù)實(shí)際上就是PDD層驅(qū)動(dòng)中需要實(shí)現(xiàn)的函數(shù)，如下：
2.4.1 virtual SCODE GetModeInfo(GPEMode *pMode, INT modeNumber)
獲得顯示模式。
pMode：輸出顯示模式結(jié)構(gòu)
modeNumber：顯示模式索引號(hào)
2.4.2 virtual int NumModes(void)
獲得當(dāng)前驅(qū)動(dòng)支持的顯示模式的個(gè)數(shù)
2.4.3 virtual SCODE SetMode(INT modeId, HPALETTE *palette)
設(shè)置顯示模式。
modeId：顯示模式索引號(hào)
palette：調(diào)色板指針，指向一個(gè)由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)建一個(gè)繪圖平面。
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：指向一個(gè)包含光標(biāo)形狀的掩碼
pColorSurface：指向被光標(biāo)使用的顏色繪圖平面
xHot：光標(biāo)熱點(diǎn)的X坐標(biāo)
yHot：光標(biāo)熱點(diǎn)的Y坐標(biāo)
cX：光標(biāo)寬度
cY：光標(biāo)高度
2.4.6 virtual SCODE MovePointer(int x, int y)
移動(dòng)光標(biāo)到指定位置或者隱藏光標(biāo)
x：光標(biāo)移動(dòng)位置的x坐標(biāo)，若為-1表示隱藏光標(biāo)。
評(píng)論