以文本方式查看主題 - 曙海教育集團(tuán)論壇 (http://www.xinguifushi.cn/bbs/index.asp) -- WinCE系統(tǒng)定制與驅(qū)動(dòng)開發(fā) (http://www.xinguifushi.cn/bbs/list.asp?boardid=36) ---- 詳解WinCE下USB Host驅(qū)動(dòng)開發(fā)(2) (http://www.xinguifushi.cn/bbs/dispbbs.asp?boardid=36&id=1815) |
-- 作者:wangxinxin -- 發(fā)布時(shí)間:2010-11-26 10:38:05 -- 詳解WinCE下USB Host驅(qū)動(dòng)開發(fā)(2) 當(dāng)用戶需要卸載USB Host設(shè)備驅(qū)動(dòng)時(shí),將會(huì)調(diào)用USBUnInstallDriver函數(shù) BOOL USBUnInstallDriver(); 它與USBInstallDriver類似,不過(guò)是調(diào)用如下兩個(gè)函數(shù) UnRegisterClientSettings BOOL UnRegisterClientSettings(LPCWSTR szUniqueDriverId, LPCWSTR szReserved, LPCUSB_DRIVER_SETTINGS lpDriverSettings); BOOL UnRegisterClientDriverID(LPCWSTR szUniqueDriverId); 其中szUniqueDriverId是注冊(cè)時(shí),使用的ID,szReserved保留,故設(shè)置為NULL,lpDriverSettings則是驅(qū)動(dòng)程序設(shè)置信息。 例程如下: BOOL USBUnInstallDriver() { RETAILMSG(1,(TEXT("USBUninstallDriver\\r\\n"))); BOOL fRet = FALSE; USB_DRIVER_SETTINGS DriverSettings; DriverSettings.dwCount = sizeof(DriverSettings); DriverSettings.dwVendorId = 0x10C4; DriverSettings.dwProductId = 0x0003; DriverSettings.dwReleaseNumber = USB_NO_INFO; DriverSettings.dwDeviceClass = USB_NO_INFO; DriverSettings.dwDeviceSubClass = USB_NO_INFO; DriverSettings.dwDeviceProtocol = USB_NO_INFO; DriverSettings.dwInterfaceClass = 0; DriverSettings.dwInterfaceSubClass = 0; DriverSettings.dwInterfaceProtocol = 0; fRet = UnRegisterClientSettings(L"USBTest", NULL, &DriverSettings); if(fRet) { fRet = UnRegisterClientDriverID(L"USBTest"); if(!fRet) RETAILMSG(1,(TEXT("UnRegisterClientDriverID error\\r\\n"))); } else RETAILMSG(1,(TEXT("UnRegisterClientSettings error\\r\\n"))); return fRet; } 其中DriverSettings必須與USBInstallDriver的DriverSettings一致。 回到原來(lái)的流程,WinCE注冊(cè)表中已經(jīng)包含了驅(qū)動(dòng)信息,WinCE系統(tǒng)自動(dòng)查找注冊(cè)表,在找到設(shè)備對(duì)應(yīng)鍵值的DLL后,將會(huì)調(diào)用該DLL的USBDeviceAttach函數(shù)。
BOOL USBDeviceAttach( USB_HANDLE hDevice, LPCUSB_FUNCS lpUsbFuncs, LPCUSB_INTERFACE lpInterface, LPCWSTR szUniqueDriverId, LPBOOL fAcceptControl, DWORD dwUnused) hDevice 設(shè)備句柄,操作USB設(shè)備時(shí),需要使用該句柄
lpUsbFuncs 指向一個(gè)包含各種USB操作的函數(shù)指針 lpInterface USB接口信息,這里需要注意的是,如果在DriverSettings里dwInterfaceClass、dwInterfaceSubClass、dwInterfaceProtocol設(shè)置為USB_NO_INFO,則該指針為NULL szUniqueDriverId 注冊(cè)設(shè)備ID fAcceptControl 該值被賦值為TRUE,表示該驅(qū)動(dòng)能操作該設(shè)備。如果不能操作該設(shè)備,則“未能識(shí)別的USB設(shè)備”對(duì)話框會(huì)再次出現(xiàn),要求用戶輸入驅(qū)動(dòng)程序名稱 dwUnused 未使用 在該函數(shù)內(nèi),主要是做一些檢查,判斷是否能驅(qū)動(dòng)設(shè)備,還有就是注冊(cè)USB事件通知回調(diào)函數(shù),以及激活流驅(qū)動(dòng)。對(duì)于檢查部分,這里不再詳細(xì)說(shuō)明。 首先,介紹一下激活流驅(qū)動(dòng)。 流驅(qū)動(dòng)為應(yīng)用程序提供了一個(gè)訪問(wèn)設(shè)備的接口,利用該接口可以像訪問(wèn)文件一樣訪問(wèn)設(shè)備。USB設(shè)備同樣可以使用該接口來(lái)為應(yīng)用程序提供支持。在注冊(cè)表的 HKEY_LOCAL_MACHINE\\Drivers\\BuiltIn鍵下,保存了各種WinCE內(nèi)建流驅(qū)動(dòng)程序的入口。這些驅(qū)動(dòng)通過(guò)device.exe在系統(tǒng)啟動(dòng)時(shí)被激活。像USB這樣的設(shè)備,只有插入時(shí),才存在流
驅(qū)動(dòng)接口,所以我們需要手動(dòng)激活流驅(qū)動(dòng)。激活流驅(qū)動(dòng)的函數(shù)是:
HANDLE ActivateDevice(LPCWSTR lpszDevKey, DWORD dwClientInfo); lpszDevKey 字符串指明了流驅(qū)動(dòng)所在注冊(cè)表的鍵。獲悉流驅(qū)動(dòng)的人都知道,流驅(qū)動(dòng)在注冊(cè)表中必須包含兩個(gè)鍵Prefix和Dll。 流驅(qū)動(dòng)中所有接口函數(shù)都有類似XXX_的前綴,而這個(gè)Prefix則指明XXX對(duì)應(yīng)的字符串,如Prefix為COM,則流驅(qū)動(dòng)包含如COM_Open、COM_Close、COM_Write、COM_Read這樣接口函數(shù)。Dll則說(shuō)明了這些函數(shù)所在的動(dòng)態(tài)鏈接庫(kù)。 在我的例子中存在如下的注冊(cè)表鍵: [HKEY_LOCAL_MACHINE\\Drivers\\USB\\ClientDrivers\\USBTest] "Prefix"="TST" "Dll"="MyUSBTest.dll" 通過(guò)dwClientInfo,可以把參數(shù)間接傳給驅(qū)動(dòng)的XXX_init。我們可以把hDevice、lpUsbFuncs、lpInterface這樣信息放置在一個(gè)結(jié)構(gòu)體中,通過(guò)該函數(shù)傳遞給流驅(qū)動(dòng)使用。 USB通知回調(diào)函數(shù),可以用來(lái)判斷各種USB事件的發(fā)生,如USB拔出。當(dāng)發(fā)生事件后,系統(tǒng)會(huì)根據(jù)注冊(cè)的回調(diào)函數(shù)做相應(yīng)的處理,在USB設(shè)備拔出后,所要做的事情,就是卸載流驅(qū)動(dòng),并釋放占用的各種資源。
注冊(cè)回調(diào)函數(shù)是一個(gè)包含在lpUsbFuncs中的函數(shù)指針: LPUN_REGISTER_NOTIFICATION_ROUTINE lpUnRegisterNotificationRoutine 該函數(shù)的聲明如下: typedef BOOL (* LPREGISTER_NOTIFICATION_ROUTINE)( USB_HANDLE hDevice, LPDEVICE_NOTIFY_ROUTINE lpNotifyRoutine, LPVOID lpvNotifyParameter ); hDevice 設(shè)備句柄 lpNotifyRoutine 回調(diào)函數(shù) lpvNotifyParameter 傳遞給回調(diào)函數(shù)的參數(shù) 在回調(diào)函數(shù)中卸載流驅(qū)動(dòng)使用
BOOL DeactivateDevice(HANDLE hDevice); 其中,hDevice 傳入ActivateDevice時(shí)返回的句柄。 下面是具體的示例:
typedef struct {
DWORD dwSize; USB_HANDLE hDevice, LPCUSB_FUNCS lpUsbFuncs, LPCUSB_INTERFACE lpInterface, HANDLE hStreamDevice; } TESTUSBINFO, PTESTUSBINFO; //回調(diào)函數(shù)
extern "C" BOOL USBDeviceNotifications( LPVOID lpvNotifyParameter, DWORD dwCode, LPDWORD *dwInfo1, LPDWORD *dwInfo2, LPDWORD *dwInfo3, LPDWORD *dwInfo4) { if (dwCode == USB_CLOSE_DEVICE) { PTESTUSBINFO pDrv = (PDRVCONTEXT) lpvNotifyParameter; DeactivateDevice(pDrv->hStreamDevice); //卸載流驅(qū)動(dòng) LocalFree(pDrv); //釋放資源 } RETAILMSG(1,(TEXT("Free Driver Resources!\\r\\n"))); return TRUE; } BOOL USBDeviceAttach(
USB_HANDLE hDevice, LPCUSB_FUNCS lpUsbFuncs, LPCUSB_INTERFACE lpInterface, LPCWSTR szUniqueDriverId, LPBOOL fAcceptControl, DWORD dwUnused) { RETAILMSG(1,(TEXT("USBDeviceAttach\\r\\n"))); *fAcceptControl = FALSE; //顯示USB設(shè)備的一些信息
if(lpInterface != NULL) { RETAILMSG(1,(TEXT("usbserialhost: DeviceAttach, IF %u, #EP:%u, Class:%u, Sub:%u, Prot:%u\\r\\n"), lpInterface->Descriptor.bInterfaceNumber, lpInterface->Descriptor.bNumEndpoints, lpInterface->Descriptor.bInterfaceClass, lpInterface->Descriptor.bInterfaceSubClass, lpInterface->Descriptor.bInterfaceProtocol)); RETAILMSG(1,(TEXT("Endpoint 1:%u\\r\\n"), lpInterface->lpEndpoints[0].Descriptor.bmAttributes)); RETAILMSG(1,(TEXT("Endpoint 2:%u\\r\\n"), lpInterface->lpEndpoints[1].Descriptor.bmAttributes)); RETAILMSG(1,(TEXT("Endpoint 3:%u\\r\\n"), lpInterface->lpEndpoints[2].Descriptor.bmAttributes)); } LPCUSB_DEVICE lpUsbDev = (lpUsbFuncs->lpGetDeviceInfo)(hDevice);
if(!lpUsbDev) { RETAILMSG(1,(TEXT("Unable to get USB device!\\r\\n"))); return FALSE; } //保存必要的信息供驅(qū)動(dòng)程序其他部分使用
PTESTUSBINFO pDrv = (PTESTUSBINFO)LocalAlloc (LPTR, sizeof (PTESTUSBINFO)); pDrv->dwSize = sizeof (DRVCONTEXT); pDrv->hDevice = hDevice; pDrv->lpUsbFuncs = lpUsbFuncs; pDrv->lpInterface = lpInterface; //激活流驅(qū)動(dòng)
pDrv->hStreamDevice = ActivateDevice (L"Drivers\\\\USB\\\\ClientDrivers\\\\USBTest", (DWORD)pDrv); if (pDrv->hStreamDevice) { //注冊(cè)回調(diào)函數(shù) (*lpUsbFuncs->lpRegisterNotificationRoutine)( hDevice, USBDeviceNotifications, pDrv); } else { RETAILMSG(1, (TEXT("Can\'t activate stream device! rc=%d\\r\\n"), GetLastError())); LocalFree(pDrv); return FALSE; } //驅(qū)動(dòng)可以操作該設(shè)備 *fAcceptControl = TRUE; return TRUE; } 至此,USB Host端設(shè)備驅(qū)動(dòng)程序所必須實(shí)現(xiàn)的功能都已經(jīng)實(shí)現(xiàn)。并且和流驅(qū)動(dòng)相連接。應(yīng)用程序已經(jīng)可以使用流驅(qū)動(dòng)的接口來(lái)操作USB設(shè)備了。 |