Wince 5.0 获取U盘描述符
最近由于项目需求，需要获取U盘的描述符。而现有的usb otg驱动中没有提供这样的接口。没有办法，只能自己动手来修改了。本人刚开始接触USB 驱动，在代码的海洋中还比较迷茫。以下代码的实现是公司内一位大牛所作，本人只是借来学习一用。也算对USB驱动有个初步的了解。
先罗嗦两句。刚开始看到文件夹usbotg，还有点不太理解是什么意思。当时在想，usb驱动为什么不直接放在usb文件夹下，而是放在usbotg文件夹下？otg是嘛意思？资料当然也很好找，usb家族里面，对该成员有详细介绍（http://www.usb.org/developers/onthego）。原来otg就是On The Go。
传统的usb协议中分为host 和function，一个设备，要么是host，要么是function。例如，一般PC是作为host，而其他的设备，U盘，打印机，相机等是作为function存在的。这样就有一个问题，对PC的依赖过大，离开了host PC，两个usb function在一起，只能干瞪眼，没办法进行交互。当然，两个host，通过usb cable接起来，也是互相不认识的。为了解决该问题，在usb 2.0的基础上，出现了otg的概念。
usbotg中，一个设备既可以作为host，也可以作为function。两个usb 设备连接到一起，根据功能的需要，其中一个（usb1）作为host，另外一个（usb2）作为function。如果功能改变了，需要把usb2作为host，而把usb1作为function，可以通过HNP（Host Negotiation Protocol）来实现。具体怎么实现，可以到usb老家里面看看协议。
由于懒惰，本人还没详细看过协议。此处只是介绍个皮毛。若有不妥之处，还望各位大虾指正。
好了，废话不多说了，一步步来看实现吧。
1、首先当然是考察可行性。
也就是驱动中是否能够提供这样的接口。调查发现，在otg driver中保存的g_OtgCoreInfo（OTG_CORE_INFO）变量中有一个m_dwHostContext成员，保存的是Host Controller Driver的Context。m_dwHostContext会在OTG_Init函数中被初始化，代码如下：
g_OtgCoreInfo.m_dwHostContext = HCD_Init((DWORD)&hostSettings);
Host Controller Driver中保存有一个g_dwPddContext（DWORD，其实是SEHCDPdd结构体的指针）变量，在函数HCD_Init（在MDD中）中会调用HcdPdd_Init函数来初始化该变量，并最终把该
变量作为函数返回值返回。代码如下：
g_dwPddContext =HcdPdd_Init(dwContext);
...
return g_dwPddContext;
HcdPdd_Init（在HDD中）函数中首先创建一个SEHCDPdd对象，然后调用InitializeEHCI函数初始化该对象，最后将该对象的指针返回。
SEHCDPdd * pPddObject = malloc(sizeof(SEHCDPdd));
...
fRet = InitializeEHCI(pPddObject, (POTG_HOST_SETTINGS)dwContext);
...
return (DWORD)pPddObject;
InitializeEHCI（在HDD中）函数中，初始化pPddObject变量中的各个成员，我们本次只关注成员lpvEHCDMddObject的初始化：
pobEHCD = HcdMdd_CreateHcdObject(pPddObject, pobMem, NULL, (PUCHAR)pHostSetting->m_dwRegBase, 0)
...
pPddObject->lpvEHCDMddObject = pobEHCD;
HcdMdd_CreateHcdObject函数（在MDD中）中调用CreateHCDObject函数创建HCD Object。并将对象指针返回。
CHcd * pobUhcd = CreateHCDObject(lpvUhcdPddObject,
(CPhysMem *)lpvMemoryObject,szRegKey,ioPortBase,dwSysIntr);
...
return pobUhcd;
CreateHCDObject函数（在HDD中）中，创建一个CEhcd对象，并返回。
return new CEhcd (pvUhcdPddObject, pCPhysMem,szDriverRegistryKey,portBase,dwSysIntr);
CEhcd类继承自CHW类，CHW类继承自CHcd类。CHcd类中包含一个CRootHub*类型的成员。
CRootHub* m_pCRootHub; // pointer to CRootHub object, which represents // the built-in hardware USB ports
CRootHub类继承自CHub类，CHub类继承自CDevice类。
CHub类中有函数获取当前hub上连接设备的列表。
CDevice** GetDeviceList() {return m_ppCDeviceOnPort;};
CDevice类包含一个m_deviceInfo（USB_DEVICE_INFO）成员变量，USB_DEVICE_INFO结构体中包含一个Descriptor（USB_DEVICE_DESCRIPTOR）成员，该成员就是用来保存USB设备的Descriptor信息的。USB_DEVICE_DESCRIPTOR结构体的内容是在USB协议中规定的。
2、既然找到了描述符的位置所在，接下来想办法把它提供出去就OK了。
首先，要追加个函数，把Descriptor的内容返回出去。该接口可以加在CDevice类，或者CHub类中。如果放在CDevice类中，只能获取该设备的Descriptor，如果想获取hub上连接的所有usb设备的descritor，还需要在CHub类，或其他地方追加接口，来对hub上连接的usb设备的list进行控制。这样比较麻烦，此处选择了一种比较懒省事的方法，在CHub类中追加接口函数（GetDeviceDescriptor），一次将hub上连接的所有usb设备的Descriptor全部取出。
遍历hub的所有port，也就是变量CHub类的成员变量m_ppCDeviceOnPort
（范围取min(m_usbHubDescriptor.bNumberOfPorts, MAX_DEVICE_PER_HUB)）
判断port上是否有设备，若有，将设备的Descripror赋值给output buffer。
（lpudd[i] = m_ppCDeviceOnPort[i]->m_deviceInfo.Descriptor;）
3、最底层的实现有了，接下来就是如何把函数一步步输出去了。
此处有个疑问，既然上面有了底层实现，我们直接在IOControl函数中追加个IOConrol Code，然后调用底层的实现不就行了？相信有些初学者也有同样的疑问。看一下第一步中的分析，就应该比较清楚了。在第一步的分析中，可以发现，不同的对象，是在不同的层中创建的。对相应对象的操作，也都在对应的层中。如果我们跳过中间层，直接访问底层实现，就破坏了分层驱动的结构。
m_pCRootHub（CRootHub）是CEHcd类的一个成员变量，所以可以通过CEHcd的对象，来最终实现对上述函数的调用。CEHcd的对象是在函数HcdMdd_CreateHcdObject中创建的，所以我们可以在HcdMdd_CreateHcdObject函数定义的地方，追加一个函数（HcdMdd_GetHubConnectedDeviceDescriptor），来实现对底层实现的调用。假设Root hub上只接了我们的hub。首先通过m_pCRootHub获取root hub上设备的列表（CHub），然后调用列表中对象的GetDeviceDescriptor函数。
CDevice **lppcd = pobHcd->m_pCRootHub->GetDeviceList();
((CHub *)lppcd[0])->GetDeviceDescriptor(lpudd);
4、从第一步的分析中可知，HcdMdd_CreateHcdObject函数的返回值，被保存在了pPddObject（SEHCDPdd）的lpvEHCDMddObject成员中。pPddObject的创建和初始化是在HcdPdd_Init函数和InitializeEHCI函数中实现的。所以在HcdPdd_层中，我们可以追加函数（HcdPdd_GetHubConnectedDeviceDescriptor），实现对函数HcdMdd_GetHubConnectedDeviceDescriptor的调用。
HcdMdd_GetExtHubConnectedDeviceDesc(pPddObject->lpvEHCDMddObject, lpudd);
5、由步骤1的分析可知，HcdPdd_Init函数在HCD_Init函数中被调用。用来给全局变量g_dwPddContext赋值。所以，可以在HCD_层中，追加函数（HCD_GetHubConnectedDeviceDescriptor），通过保存的全局变量，实现对函数HcdPdd_GetHubConnectedDeviceDescriptor的调用。
6、继续往上，函数OTG_Init中调用了函数HCD_Init。终于到头了，此时，我们可以在OTG_IOControl函数中追加一个case，来调用函数HCD_GetHubConnectedDeviceDescriptor。当然，要追加相应的IOCTL Code的定义。
如果不需要Descriptor的全部信息，可以定义一个自己的结构体，在GetDeviceDescriptor函数中，取出Descriptor的部分成员，赋值给自己定义的结构体即可。
IOCTL 和结构体的定义，可以放在文件USB_def.h文件中。
参考：
typedef struct __OTG_CORE_INFO {
DWORD m_dwRegBase; // @field Base address of core registers
HINTR m_hSysIntr; // @field Handle returned by the OS_RegisterInterrupt
DWORD m_dwSysIntr; // @field System interrupt number of OTG controller
DWORD m_dwOpenCnt; // @field Open counter of the driver
DWORD m_dwHostContext; // @field Context of host controller driver
DWORD m_dwFuncContext; // @field Context of function controller driver
DWORD m_dwFuncBusContext; // @field context of function controller bus
BOOL bInSleepOrSM_Mode;
BOOL bInPowerHandler;
// Note: Implementation of the message queue is OS-dependent
HPROC m_hSrcProc; // @field Handle to a source process that owns the m_hMsgQ
HMSGQ m_hMsgQ; // @field Handle to opened message queue
DWORD m_dwPortNum;
DWORD m_dwPortMode;
} OTG_CORE_INFO, *POTG_CORE_INFO;
typedef struct _SEHCDPdd
{
LPVOID lpvMemoryObject;
LPVOID lpvEHCDMddObject;
PVOID pvVirtualAddress; // DMA buffers as seen by the CPU
DWORD dwPhysicalMemSize;
PHYSICAL_ADDRESS LogicalAddress; // DMA buffers as seen by the DMA controller and bus interfaces
DMA_ADAPTER_OBJECT AdapterObject;
TCHAR szDriverRegKey[MAX_PATH];
PUCHAR ioPortBase;
DWORD dwSysIntr;
CRITICAL_SECTION csPdd; // serializes access to the PDD object
HANDLE IsrHandle;
HANDLE hParentBusHandle;
} SEHCDPdd;
typedef struct _USB_DEVICE_INFO {
DWORD dwCount;
USB_DEVICE_DESCRIPTOR Descriptor;
LPNON_CONST_USB_CONFIGURATION lpConfigs;
LPNON_CONST_USB_CONFIGURATION lpActiveConfig;
} USB_DEVICE_INFO, * LPUSB_DEVICE_INFO;
typedef struct _USB_DEVICE_DESCRIPTOR
{
BYTE bLength;
BYTE bDescriptorType;
BYTE bcdUSBLo;
BYTE bcdUSBHi;
BYTE bDeviceClass;
BYTE bDeviceSubClass;
BYTE bDeviceProtocol;
BYTE bMaxPacketSize0;
BYTE idVendorLo;
BYTE idVendorHi;
BYTE idProductLo;
BYTE idProductHi;
BYTE bcdDeviceLo;
BYTE bcdDeviceHi;
BYTE iManufacturer;
BYTE iProduct;
BYTE iSerialNumber;
BYTE bNumConfigurations;
} USB_DEVICE_DESCRIPTOR, * PUSB_DEVICE_DESCRIPTOR;
