以文本方式查看主题 - 曙海教育集团论坛 (http://sun4.cn/bbs/index.asp) -- WinCE系统定制与驱动开发 (http://sun4.cn/bbs/list.asp?boardid=36) ---- 详解WinCE下USB Host驱动开发(2) (http://sun4.cn/bbs/dispbbs.asp?boardid=36&id=1815) |
-- 作者:wangxinxin -- 发布时间:2010-11-26 10:38:05 -- 详解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 = 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一致。 回到原来的流程,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 dwSize; USB_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) lpvNotifyParameter; DeactivateDevice(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[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; } //保存必要的信息供驱动程序其他部分使用
PTESTUSBINFO pDrv = (PTESTUSBINFO)LocalAlloc (LPTR, sizeof (PTESTUSBINFO)); pDrv->dwSize = sizeof (DRVCONTEXT); pDrv->hDevice = hDevice; pDrv->lpUsbFuncs = lpUsbFuncs; pDrv->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 = TRUE; return TRUE; } 至此,USB Host端设备驱动程序所必须实现的功能都已经实现。并且和流驱动相连接。应用程序已经可以使用流驱动的接口来操作USB设备了。 |