作者:深圳市英贝德科技有限公司
转自:http://www.gkong.com/learn/learn_detail.asp?learn_id=13391
当用户需要卸载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一致。
BOOL USBDeviceAttach(
USB_HANDLE hDevice,
LPCUSB_FUNCS lpUsbFuncs,
LPCUSB_INTERFACE lpInterface,
LPCWSTR szUniqueDriverId,
LPBOOL fAcceptControl,
DWORD dwUnused)
lpUsbFuncs 指向一个包含各种USB操作的函数指针
lpInterface USB接口信息,这里需要注意的是,如果在DriverSettings里dwInterfaceClass、dwInterfaceSubClass、dwInterfaceProtocol设置为USB_NO_INFO,则该指针为NULL
szUniqueDriverId 注册设备ID
fAcceptControl 该值被赋值为TRUE,表示该驱动能操作该设备。如果不能操作该设备,则“未能识别的USB设备”对话框会再次出现,要求用户输入驱动程序名称
dwUnused 未使用
在该函数内,主要是做一些检查,判断是否能驱动设备,还有就是注册USB事件通知回调函数,以及激活流驱动。对于检查部分,这里不再详细说明。
首先,介绍一下激活流驱动。
流驱动为应用程序提供了一个访问设备的接口,利用该接口可以像访问文件一样访问设备。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这样信息放置在一个结构体中,通过该函数传递给流驱动使用。
注册回调函数是一个包含在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时返回的句柄。
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;
}
USB_HANDLE hDevice,
LPCUSB_FUNCS lpUsbFuncs,
LPCUSB_INTERFACE lpInterface,
LPCWSTR szUniqueDriverId,
LPBOOL fAcceptControl,
DWORD dwUnused)
{
RETAILMSG(1,(TEXT("USBDeviceAttach\r\n")));
*fAcceptControl = FALSE;
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));
}
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设备了。