|
詳解WinCE下USB Host驅動開發(2)
當用戶需要卸載USB Host設備驅動時，將會調用USBUnInstallDriver函數BOOL USBUnInstallDriver()
它與USBInstallDriver類似，不過是調用如下兩個函數UnRegisterClientSettings BOOL UnRegisterClientSettings(LPCWSTR szUniqueDriverId, LPCWSTR szReserved, LPCUSB_DRIVER_SETTINGS lpDriverSettings)
BOOL UnRegisterClientDriverID(LPCWSTR szUniqueDriverId)
其中szUniqueDriverId是注冊時，使用的ID，szReserved保留，故設置為NULL，lpDriverSettings則是驅動程序設置信息。例程如下：BOOL USBUnInstallDriver(){RETAILMSG(1,(TEXT("USBUninstallDriver\r\n")))BOOL fRet = FALSEUSB_DRIVER_SETTINGS DriverSettingsDriverSettings.dwCount = sizeof(DriverSettings)DriverSettings.dwVendorId = 0x10C4DriverSettings.dwProductId = 0x0003DriverSettings.dwReleaseNumber = USB_NO_INFODriverSettings.dwDeviceClass = USB_NO_INFODriverSettings.dwDeviceSubClass = USB_NO_INFODriverSettings.dwDeviceProtocol = USB_NO_INFODriverSettings.dwInterfaceClass = 0DriverSettings.dwInterfaceSubClass = 0DriverSettings.dwInterfaceProtocol = 0fRet = UnRegisterClientSettings(L"USBTest", NULL, DriverSettings)if(fRet) {fRet = UnRegisterClientDriverID(L"USBTest")if(!fRet)RETAILMSG(1,(TEXT("UnRegisterClientDriverID error\r\n")))} elseRETAILMSG(1,(TEXT("UnRegisterClientSettings error\r\n")))return fRet} 其中DriverSettings必須與USBInstallDriver的DriverSettings一致。
回到原來的流程，WinCE注冊表中已經包含了驅動信息，WinCE系統自動查找注冊表，在找到設備對應鍵值的DLL后，將會調用該DLL的USBDeviceAttach函數。BOOL USBDeviceAttach(USB_HANDLE hDevice,LPCUSB_FUNCS lpUsbFuncs,LPCUSB_INTERFACE lpInterface,LPCWSTR szUniqueDriverId,LPBOOL fAcceptControl,DWORD dwUnused)
hDevice 設備句柄，操作USB設備時，需要使用該句柄 lpUsbFuncs 指向一個包含各種USB操作的函數指針 lpInterface USB接口信息，這里需要注意的是，如果在DriverSettings里dwInterfaceClass、dwInterfaceSubClass、dwInterfaceProtocol設置為USB_NO_INFO，則該指針為NULL
szUniqueDriverId 注冊設備ID fAcceptControl 該值被賦值為TRUE，表示該驅動能操作該設備。如果不能操作該設備，則“未能識別的USB設備”對話框會再次出現，要求用戶輸入驅動程序名稱 dwUnused 未使用
在該函數內，主要是做一些檢查，判斷是否能驅動設備，還有就是注冊USB事件通知回調函數，以及激活流驅動。對于檢查部分，這里不再詳細說明。 首先，介紹一下激活流驅動。 流驅動為應用程序提供了一個訪問設備的接口，利用該接口可以像訪問文件一樣訪問設備。USB設備同樣可以使用該接口來為應用程序提供支持。在注冊表的
HKEY_LOCAL_MACHINE\Drivers\BuiltIn鍵下，保存了各種WinCE內建流驅動程序的入口。這些驅動通過device.exe在系統啟動時被激活。像USB這樣的設備，只有插入時，才存在流
驅動接口，所以我們需要手動激活流驅動。激活流驅動的函數是： HANDLE ActivateDevice(LPCWSTR lpszDevKey, DWORD dwClientInfo)lpszDevKey 字符串指明了流驅動所在注冊表的鍵。獲悉流驅動的人都知道，流驅動在注冊表中必須包含兩個鍵Prefix和Dll。 流驅動中所有接口函數都有類似XXX_的前綴，而這個Prefix則指明XXX對應的字符串，如Prefix為COM，則流驅動包含如COM_Open、COM_Close、COM_Write、COM_Read這樣接口函數。Dll則說明了這些函數所在的動態鏈接庫。在我的例子中存在如下的注冊表鍵：[HKEY_LOCAL_MACHINE\Drivers\USB\ClientDrivers\USBTest] "Prefix"="TST" "Dll"="MyUSBTest.dll" 通過dwClientInfo，可以把參數間接傳給驅動的XXX_init。我們可以把hDevice、lpUsbFuncs、lpInterface這樣信息放置在一個結構體中，通過該函數傳遞給流驅動使用。
USB通知回調函數，可以用來判斷各種USB事件的發生，如USB拔出。當發生事件后，系統會根據注冊的回調函數做相應的處理，在USB設備拔出后，所要做的事情，就是卸載流驅動，并釋放占用的各種資源。 注冊回調函數是一個包含在lpUsbFuncs中的函數指針：LPUN_REGISTER_NOTIFICATION_ROUTINE lpUnRegisterNotificationRoutine該函數的聲明如下：typedef BOOL (* LPREGISTER_NOTIFICATION_ROUTINE)( USB_HANDLE hDevice, LPDEVICE_NOTIFY_ROUTINE lpNotifyRoutine, LPVOID lpvNotifyParameter)hDevice 設備句柄lpNotifyRoutine 回調函數lpvNotifyParameter 傳遞給回調函數的參數
在回調函數中卸載流驅動使用BOOL DeactivateDevice(HANDLE hDevice)其中，hDevice 傳入ActivateDevice時返回的句柄。
下面是具體的示例：
typedef struct {DWORD dwSizeUSB_HANDLE hDevice,LPCUSB_FUNCS lpUsbFuncs,LPCUSB_INTERFACE lpInterface,HANDLE hStreamDevice} TESTUSBINFO, PTESTUSBINFO
//回調函數extern "C" BOOL USBDeviceNotifications(LPVOID lpvNotifyParameter,DWORD dwCode,LPDWORD *dwInfo1,LPDWORD *dwInfo2,LPDWORD *dwInfo3,LPDWORD *dwInfo4){if (dwCode == USB_CLOSE_DEVICE) {PTESTUSBINFO pDrv = (PDRVCONTEXT) lpvNotifyParameterDeactivateDevice(pDrv-hStreamDevice) //卸載流驅動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設備的一些信息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.Descriptor.bmAttributes))RETAILMSG(1,(TEXT("Endpoint 2:%u\r\n"), lpInterface-lpEndpoints.Descriptor.bmAttributes))RETAILMSG(1,(TEXT("Endpoint 3:%u\r\n"), lpInterface-lpEndpoints.Descriptor.bmAttributes))}
LPCUSB_DEVICE lpUsbDev = (lpUsbFuncs-lpGetDeviceInfo)(hDevice)if(!lpUsbDev){RETAILMSG(1,(TEXT("Unable to get USB device!\r\n")))return FALSE}
//保存必要的信息供驅動程序其他部分使用PTESTUSBINFO pDrv = (PTESTUSBINFO)LocalAlloc (LPTR, sizeof (PTESTUSBINFO))pDrv-dwSize = sizeof (DRVCONTEXT)pDrv-hDevice = hDevicepDrv-lpUsbFuncs = lpUsbFuncspDrv-lpInterface = lpInterface
//激活流驅動pDrv-hStreamDevice = ActivateDevice (L"Drivers\\USB\\ClientDrivers\\USBTest", (DWORD)pDrv)if (pDrv-hStreamDevice) {//注冊回調函數(*lpUsbFuncs-lpRegisterNotificationRoutine)(hDevice,USBDeviceNotifications,pDrv)} else {RETAILMSG(1, (TEXT("Can't activate stream device! rc=%d\r\n"), GetLastError()))LocalFree(pDrv)return FALSE}//驅動可以操作該設備*fAcceptControl = TRUEreturn TRUE}
至此，USB Host端設備驅動程序所必須實現的功能都已經實現。并且和流驅動相連接。應用程序已經可以使用流驅動的接口來操作USB設備了。
|
加好友 
發短信
Post By：2010-11-26 11:00:37
