工控自动化技术文摘：详解WinCE下USB Host驱动开发(1)

负责向注册表添加USB Host驱动的信息，以便再次插入设备时，能够识别该USB设备。其原型如下：

    BOOL USBInstallDriver(LPCWSTR szDriverLibFile);
    其中szDriverLibFile就是输入的DLL文件名称。返回TRUE表示注册成功。
    在向注册表注册USB Host信息时，不能使用普通的注册表函数，只能使用USBD提供的注册函数。
    BOOL RegisterClientDriverID(LPCWSTR szUniqueDriverId);
    BOOL RegisterClientSettings(LPCWSTR szDriverLibFile, LPCWSTR             szUniqueDriverId, LPCWSTR erved, LPCUSB_DRIVER_SETTINGS lpDriverSettings);
    这两个函数在USBD.DLL中，可以通过动态方式调用，也可以通过静态方式调用。

动态方式如下：
HINSTANCE hInst = LoadLibrary(L"USBD.DLL");
if(hInst) {
LPREGISTER_CLIENT_DRIVER_ID lpRegisterClientId =
  (LPREGISTER_CLIENT_DRIVER_ID)GetProcAddress(
   hInst,
   L"RegisterClientDriverID");
if(!lpRegisterClientId)
  return FALSE;
LPREGISTER_CLIENT_SETTINGS lpRegisterClientSetting =
  (LPREGISTER_CLIENT_SETTINGS)GetProcAddress(
   hInst,
   L"RegisterClientSettings");
if(!lpRegisterClientSetting)
  return FALSE;
else
return FALSE;
    此后，就可以通过lpRegisterClientId和lpRegisterClientSetting函数指针调用这些函数，最后记得要FreeLibrary。

静态方式：
在.cpp源文件中加入
#pragma   comment(lib,"usbd.lib")
并在source文件的TARGETLIBS变量中加入$(_SYSGENOAKROOT)\lib\$(_CPUINDPATH)\usbd.lib
如此一来，就可以直接使用这两个函数了。

1) BOOL RegisterClientDriverID(LPCWSTR szUniqueDriverId)
该函数注册USB Host驱动程序的ID。
2) BOOL RegisterClientSettings(LPCWSTR szDriverLibFile, LPCWSTR szUniqueDriverId, LPCWSTR erved, LPCUSB_DRIVER_SETTINGS lpDriverSettings)
该函数负责注册驱动程序的信息。
szDriverLibFile 设置为USBInstallDriver函数传入的DLL驱动程序名称。
szUniqueDriverId 设置为调用RegisterClientDriverID注册的驱动程序ID。
erved 设置为NULL
lpDriverSettings 该参数是一个USB_DRIVER_SETTINGS结构体。其声明如下：
typedef struct {
DWORD dwCount;
DWORD dwVendorId;
DWORD dwProductId;
DWORD dwReleaseNumber;
DWORD dwDeviceClass;
DWORD dwDeviceSubClass;
DWORD dwDeviceProtocol;
DWORD dwInterfaceClass;
DWORD dwInterfaceSubClass;
DWORD dwInterfaceProtocol;
} USB_DRIVER_SETTINGS;
    Count为结构体大小，其他项对应USB描述符。
    其中除Count外的各字段，如果不设置具体的值，可以设置为USB_NO_INFO。
这个结构体中的信息讲反应到注册表的HKEY_LOCAL_MACHINE\Drivers\USB\LoadClients\键下，用于在USB设备插入时，查找USB驱动。下面以一个例子说明：
BOOL USBInstallDriver(LPCWSTR szDriverLibFile)
{
RETAILMSG(1,(TEXT("USBInstallDriver\r\n")));
RETAILMSG(1,(TEXT("USBInstallDriver:%s\r\n"), szDriverLibFile));
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 = RegisterClientDriverID(L"USBTest");
if (fRet) {
  fRet = RegisterClientSettings(
   szDriverLibFile,
   L"USBTest",
   NULL,
   &DriverSettings);
  if(!fRet)
   RETAILMSG(1,(TEXT("RegisterClientSettings error\r\n")));
} else
  RETAILMSG(1,(TEXT("RegisterClientDriverID error\r\n")));

return fRet;
}

在WinCE中，将设置信息分为了三组，每组3个值，
第一组：
dwVendorId、dwProductId、dwReleaseNumber
第二组：
dwDeviceClass、dwDeviceSubClass、dwDeviceProtocol
第三组：
dwInterfaceClass、dwInterfaceSubClass、dwInterfaceProtocol
    如果注册成功，将会在HKEY_LOCAL_MACHINE\Drivers\USB\LoadClients\键下出现 “第一组\第二组\第三组\注册ID\DLL”这样的建，键值为DLL驱动名称。其中每组又是由三个值中间加下划线组成。如果有一个值设置为USB_NO_INFO，则键名不包括该值。如果整个组中每个值都设置成USB_NO_INFO，则键名为Default。

据上面的例子，在我的系统下，将会生成如下键名：
    HKEY_LOCAL_MACHINE\Drivers\USB\LoadClients\4292_3\Default\0_0_0\USBTest\DLL = "MyUSBTest" (我的驱动程序为MyUSBTest.dll)
    当用户插入USB设备时，它会读取USB设备的描述符，根据描述符中的值在注册表中查找驱动程序名称。

    现在假设，我们要WinCE只支持USB键盘，另外我们自己实现一个USB鼠标驱动程序。如果不加注意，我们的USB鼠标驱动程序将不能被调用。原因正是在于这个查找USB设备驱动的过程。WINCE提供的USBHID驱动程序的注册表信息是
    HKEY_LOCAL_MACHINE\Drivers\USB\LoadClients\Default\Default\3\Hid_Class\DLL = "USBHID.DLL"

    其中第三组信息只使用了dwInterfaceClass，而USB键盘和USB鼠标只有dwInterfaceProtocol不同。所以，一个3概括了所有的HID，当我们的USB鼠标插入系统后，将会调用USBHID.DLL驱动程序处理，但是它只包括键盘的驱动，没有鼠标的驱动，所以鼠标不能使用。要想使得自定义的USB鼠标可以使用，则将第三组的值都设置上，如下：
    HKEY_LOCAL_MACHINE\Drivers\USB\LoadClients\Default\Default\3_1_1\Hid_Class\DLL = "USBHID.DLL"

    如此一来，当值为3_1_2的鼠标插入后，因为找不到对应的键值，将提示要求我们输入USB鼠标的驱动。