|
详解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
