WinCE Display驅動開發(fā)介紹
加入技術交流群
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指針給上層接口。
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ù)自己的要求靈活掌握，也可以在這里初始化顯示設備或做其他的初始化工作。
4 實現(xiàn)GPE類中的函數(shù)
由于NewGPE繼承于GPE類，所以必須實現(xiàn)GPE類中的所有純虛函數(shù)，這些函數(shù)實際上就是PDD層驅動中需要實現(xiàn)的函數(shù)，如下：
4.1 virtual SCODE GetModeInfo(GPEMode *pMode, INT modeNumber)
獲得顯示模式。
pMode：輸出顯示模式結構
modeNumber：顯示模式索引號
4.2 virtual int NumModes(void)
獲得當前驅動支持的顯示模式的個數(shù)
4.3 virtual SCODE SetMode(INT modeId, HPALETTE *palette)
設置顯示模式。
modeId：顯示模式索引號
palette：調色板指針，指向一個由EngCreatePalette函數(shù)創(chuàng)建的調色板
4.4 virtual SCODE AllocSurface(GPESurf **surface, INT width, INT height, EGPEFormat format, INT surfaceFlags)
在系統(tǒng)內存中創(chuàng)建一個繪圖平面。
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)
在做位塊傳輸前會先執(zhí)行該函數(shù)，用于確定執(zhí)行BLT的函數(shù)
blitParameters：指向一個GPE的位塊傳輸參數(shù)的結構體
4.8 virtual SCODE BltComplete(GPEBltParms *blitParameters)
該函數(shù)用于釋放在BltPrepare中申請的資源
blitParameters：指向一個GPE的位塊傳輸參數(shù)的結構體
4.9 virtual SCODE Line(GPELineParms *lineParameters, EGPEPhase phase)
畫線函數(shù)
lineParameters：指向一個GPE的Line結構體，描述所畫的線
phase：畫線所處的階段，具體描述如下
gpeSingle：畫單根線
gpePrepare：準備畫線
gpeContinue：畫線過程中
gpeComplete：畫線完成
在這里要提一點，有時我們會看到在該函數(shù)中調用另一個函數(shù)WrappedEmulatedLine(..)，這個函數(shù)在WinCE的PUBLIC目錄下的參考Display驅動中也可以找到，該函數(shù)是一個快速的畫線函數(shù)，里面采用了Bresenham畫線算法，通過采用運行速度快的加減和移位運算來完成畫線。
4.10 virtual SCODE SetPalette(const PALETTEENTRY *pSource, USHORT firstEntry, USHORT numEntries)
設置調色板
pSource：指向一個調色板入口信息的結構體
firstEntry：第一個入口
numEntries：入口的個數(shù)
4.11 virtual int InVBlank(void)
顯示設備是否處于垂直消隱期間
上述函數(shù)在GPE類中均被定義為純虛函數(shù)，需要在繼承類中實現(xiàn)，也就是在我們的驅動程序中實現(xiàn)。這些函數(shù)是必須實現(xiàn)的。根據(jù)顯示的需求，還可以在顯示驅動中添加其他的函數(shù)，比如對光標的支持，對旋轉的支持等，如下：
4.12 void CursorOn(void)
使能光標顯示。
4.13 void CursorOff(void)
禁止光標顯示。
4.14 void SetRotateParms(void)
設置屏幕翻轉參數(shù)。
4.15 void DynRotate(int angel)
支持動態(tài)翻轉。
angel：翻轉角度
4.16 ULONG *APIENTRY DrvGetMasks(DHPDEV dhpdev)
獲得顯示模式的RGB掩碼
dhpdev：指向掩碼信息，比如RGB565模式為(0xf800，0x07e0，0x001f)
NOTE：該函數(shù)必須在驅動中被實現(xiàn)。
4.17 PowerHandler(BOOL bOff)
電源控制。
bOff：TRUE表示關閉電源，F(xiàn)ALSE表示打開電源
4.18 ULONG DrvEscape(DHPDEV dhpdev, SURFOBJ* pso, ULONG iEsc, ULONG cjIn, PVOID pvIn, ULONG cjOut, PVOID pvOut)
該函數(shù)提供給應用程序的一個直接訪問顯示驅動的接口，和流設備驅動中的IoCtls函數(shù)類似。應用程序通過調用ExtEscape函數(shù)傳送操作碼和數(shù)據(jù)給顯示設備驅動，DrvEscape函數(shù)會接收到數(shù)據(jù)并進行處理，然后返回相應結果給EstEscape函數(shù)。用戶也可以根據(jù)需要自己定義相應的操作碼。
dhpdev：設備句柄
pso：指向一個繪圖平面的結構
iEsc：操作碼
cjIn：輸入數(shù)據(jù)buffer的大小
pvIn：指向輸入數(shù)據(jù)buffer
cjOut：輸出數(shù)據(jù)buffer的大小
pvOut：指向輸出數(shù)據(jù)buffer
評論