Windows主机端与自定义USBHID设备通信详解
说明：
-以下结论都是基于WindowsXP系统所得出的，不保证在其他系统的适用性。
-在此讨论的是HID自定义设备，对于标准设备，譬如USB鼠标和键盘，由于操作系统对其独占，许多操作未必能正确执行。
1．所使用的典型WindowsAPI
CreateFile ReadFile WriteFile
以下函数是DDK的内容： HidD_SetFeature HidD_GetFeature HidD_SetOutputReport HidD_GetInputReport
其中，CreateFile用于打开设备；ReadFile、HidD_GetFeature、HidD_GetInputReport用于设备到主机方向的数据通信；WriteFile、HidD_SetFeature、HidD_SetOutputReport用于主机到设备方向的数据通信。鉴于实际应用，后文主要讨论CreateFile，WriteFile，ReadFile，HidD_SetFeature四个函数，明白了这四个函数，其它的可以类推之。
2．几个常见错误
当使用以上API时，如果操作失败，调用GetLastError()会得到以下常见错误： 6：句柄无效
23：数据错误（循环冗余码检查） 87：参数错误
1784：用户提供的buffer无效 后文将会详细说明这些错误情况。
3．主机端设备枚举程序流程
4．函数使用说明
CreateFile(devDetail->DevicePath,//设备路径 GENERIC_READ|GENERIC_WRITE,//访问方式 FILE_SHARE_READ|FILE_SHARE_WRITE,//共享模式 NULL,
OPEN_EXISTING,//文件不存在时，返回失败
FILE_FLAG_OVERLAPPED,//以重叠（异步）模式打开 NULL);
在这里，CreateFile用于打开HID设备，其中设备路径通过函数SetupDiGetInterfaceDevi
ceDetail取得。CreateFile有以下几点需要注意：
-访问方式：如果是系统独占设备，例如鼠标、键盘等等，应将此参数设置为0，否则后续函数操作将失败（譬如HidD_GetAttributes）；也就是说，不能对独占设备进行除了查询以外的任何操作，所以能够使用的函数也是很有限的，下文的一些函数并不一定适合这些设备。在此顺便列出MSDN上关于此参数的说明：
If this parameter is zero, the application can query file and device attributes without accessing the device. This is useful if an application wants to determine the size of a floppy disk drive and the formats it supports without requiring a floppy in the drive. It can also be used to test for the file's or directory's existence without opening it for read or write access。
-重叠（异步）模式：此参数并不会在此处表现出明显的意义，它主要是对后续的WriteFile，ReadFile有影响。如果这里设置为重叠（异步）模式，那么在使用WriteFile，ReadFile时也应该使用重叠（异步）模式，反之亦然。这首先要求WriteFile，ReadFile的最后一个参数不能为空（NULL）。否则，便会返回87（参数错误）错误号。当然，87号错误并不代表就是此参数不正确，更多的信息将在具体讲述这两个函数时指出。此参数为0时，代表同步模式，即WriteFile，ReadFile操作会在数据处理完成之后才返回，否则阻塞在函数内部。
ReadFile(hDev,//设备句柄，即CreateFile的返回值 recvBuffer,//用于接收数据的buffer IN_REPORT_LEN,//要读取数据的长度 &recvBytes,//实际收到的数据的字节数 &ol);//异步模式
在这里，ReadFile用于读取HID设备通过中断IN传输发来的输入报告。有以下几点要注意：
1、ReadFile的调用不会引起设备的任何反应，即HID设备与主机之间的中断IN传输不与ReadFile打交道。实际上主机会在最大间隔时间（由设备的端点描述符来指定）内轮询设备，发出中断IN传输的请求。“读取”即意味着从某个buffer里面取回数据，实际上这个buffer就是HID设备驱动中的buffer。这个buffer的大小可以通过HidD_SetNumInputBuffers来改变。在XP上缺省值是32（个报告）。
2、读取的数据对象是输入报告，也即通过中断输入管道传入的数据。所以，如果设备不支持中断IN传输，那么是无法使用此函数来得到预期结果的。实际上这种情况不可能在HID中出现，因为协议指明了至少要有一个中断IN端点。
3、IN_REPORT_LEN代表要读取的数据的长度（实际的数据正文+一个byte的报告ID），这里是一个常数，主要是因为设备固件的信息我是完全知道的，当然知道要读取多少数据（也就
是报告的长度）；不过也可以通过另外的函数（
HidD_GetPrepars
edData）来事先取得报告的长度，这里不做详细讨论。因为很难想象在不了解固件
信息的情况下来做自定义设备的HID通信，在实际应用中一般来说就是固件与PC程序匹配着来开发。此参数如果设置过大，不会有实质性的错误，在recvBytes参数中会输出实际读到的长度；如果设置过小，即小于报告的长度，会返回1784号错误（用户提供的buffer无效）。
4、关于异步模式。前面已经提过，此参数的设置必须与CreateFile时的设置相对应，否则会返回87号错误（参数错误）。如果不需要异步模式，此参数需置为NULL。在这种情况下，ReadFile会一直等待直到数据读取成功，所以会阻塞住程序的当前过程。
WriteFile(hDev,//设备句柄，即CreateFile的返回值 reportBuf,//存有待发送数据的buffer OUT_REPORT_LEN,//待发送数据的长度 &sendBytes,//实际收到的数据的字节数 &ol);//异步模式
在这里，WriteFile用于传输一个输出报告给HID设备。有以下几点要注意：
1、与ReadFile不同，WriteFile函数被调用后，虽然也是经过驱动程序，但是最终会反映到设备中。也就是说，调用WriteFile后，设备会接收到输出报告的请求。如果设备使用了中断OUT传输，则WriteFile会通过中断OUT管道来进行传输；否则会使用SetReport请求通过控制管道来传输。
2、OUT_REPORT_LEN代表要写入的数据长度（实际的数据正文+一个byte的报告ID）。如果大于实际报告的长度，则使用实际报告长度；如果小于实际报告长度，会返回1784号错误（用户提供的buffer无效）。
3、reportBuf[0]必须存有待发送报告的ID，并且此报告ID指示的必须是输出报告，否则会返回87号错误（参数错误）。这种情况可能容易被程序员忽略，结果不知错误号所反映的是什么，网上也经常有类似疑问的帖子。顺便指出，输入报告、输入报告、特征报告这些报告类型，是反映在HID设备的报告描述符中。后文将做举例讨论。
4、关于异步模式。前面已经提过，此参数的设置必须与CreateFile时的设置相对应，否则会返回87号错误（参数错误）。如果不需要异步模式，此参数需置为NULL。在这种情况下，WriteFile会一直等待直到数据读取成功，所以会阻塞住程序的当前过程。
HidD_SetFeature(hDev,//设备句柄，即CreateFile的返回值
相关推荐：
loading