基于GWES的WinCE Display驅動開發(fā)介紹
void CursorOn(void);
void CursorOff(void);
#ifdef ROTATE
void SetRotateParms();
LONG DynRotate(int angle);
#endif
};
類NewGPE從GPE類上面繼承,其中包括一些屬性,如下:
m_ModeInfo:顯示模式,結構如下
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:光標使能標記
m_CursorVisible:光標可視標記
用戶可以根據(jù)需要定義相應的屬性,在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構造函數(shù)會被調用,一般我們會在這里面作一些與顯示相關的初始化的工作。該函數(shù)返回gGPE指針給上層接口。
2.3 實現(xiàn)DrvEnableDriver和DisplayInit函數(shù)
Display驅動對上層的GWES模塊提供了20多個函數(shù)接口,但是這些函數(shù)并不是直接提供出來的,實際上只是通過一個DrvEnableDriver()函數(shù)來完成的。該函數(shù)在Display驅動的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結構的大小。
data:指向DRVENABLEDATA結構體。
engineCallbacks:指向一個回調函數(shù)結構體,傳入一些GDI函數(shù)到Display驅動中。
其中,DRVENABLEDATA結構中包含了Display驅動中的設備接口函數(shù)的指針,在DrvEnableDriver函數(shù)中調用了GPEEnableDriver函數(shù),該函數(shù)會導出GWES模塊所需的所有Display驅動的接口函數(shù)。同時GWES模塊通過第四個參數(shù)engineCallbacks提供回調函數(shù)供Display驅動調用。該函數(shù)在”ddi_if”中定義。
另一個重要的函數(shù)是DisplayInit函數(shù),它是第一個被執(zhí)行的Display驅動中的函數(shù),該函數(shù)主要用于讀取注冊表中的一些信息并作判斷。該函數(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:注冊表中顯示驅動的相關注冊表值
dwNumMonitors:支持的Monitor的個數(shù)
在該函數(shù)中主要通過讀取注冊表信息判斷顯示驅動的存在,如果返回錯誤,則GWES會停止Display驅動的初始化。當然,用戶可以根據(jù)自己的要求靈活掌握,也可以在這里初始化顯示設備或做其他的初始化工作。
2.4 實現(xiàn)GPE類中的函數(shù)
由于NewGPE繼承于GPE類,所以必須實現(xiàn)GPE類中的所有純虛函數(shù),這些函數(shù)實際上就是PDD層驅動中需要實現(xiàn)的函數(shù),如下:
2.4.1 virtual SCODE GetModeInfo(GPEMode *pMode, INT modeNumber)
獲得顯示模式。
pMode:輸出顯示模式結構
modeNumber:顯示模式索引號
2.4.2 virtual int NumModes(void)
獲得當前驅動支持的顯示模式的個數(shù)
2.4.3 virtual SCODE SetMode(INT modeId, HPALETTE *palette)
設置顯示模式。
modeId:顯示模式索引號
palette:調色板指針,指向一個由EngCreatePalette函數(shù)創(chuàng)建的調色板
2.4.4 virtual SCODE AllocSurface(GPESurf **surface, INT width, INT height, EGPEFormat format, INT surfaceFlags)
在系統(tǒng)內存中創(chuàng)建一個繪圖平面。
surface:指向被分配的內存的指針
width:寬度
height:高度
format:繪圖平面格式
surfaceFlags:標記位,標明在哪分配內存
2.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:光標高度
2.4.6 virtual SCODE MovePointer(int x, int y)
移動光標到指定位置或者隱藏光標
x:光標移動位置的x坐標,若為-1表示隱藏光標。
評論