VC HID开发笔记

【VC HID开发笔记】 在开发基于Visual C++(VC)的USB HID(Human Interface Device)应用程序时，我们需要理解和掌握一些关键知识点。以下是一份详细的开发笔记，涵盖了从包含头文件到使用API函数进行设备交互的整个流程。 1. **头文件包含与库文件链接** 在VC中开发HID应用，首先需要包含`setupapi.h`和`hidsdi.h`这两个头文件。由于这些是C语言的库，所以在包含时需使用`extern "C"`来声明。之后，在项目设置的“Link”选项卡下的“Object/Library Modules”中添加`setupapi.lib`和`hid.lib`作为链接库。 2. **Windows操作HID设备的API** - `HidD_GetHidGuid`: 该函数用于获取HID设备的GUID，是识别设备类别的基础。 - `SetupDiGetClassDevs`: 返回一个设备信息集，包含指定类的所有设备，通常用于检索HID设备。 - `SetupDiEnumDeviceInterfaces`: 遍历设备信息集中指定类别的设备接口，获取设备接口的详细信息。 - `SetupDiGetDeviceInterfaceDetail`: 获取设备接口的详细信息，包括设备路径，这对于创建设备句柄至关重要。 - `HidD_GetAttributes`: 提供设备的属性信息，如厂商ID、产品ID和版本号。 - `HidP_GetValueCaps`: 用于获取设备的能力描述，这些描述定义了设备能报告的值。 - `CreateFile`, `ReadFile`, `WriteFile`: 这些是内核模式API，用于打开、读写设备，实现设备通信。 - `CloseHandle`: 关闭由`CreateFile`创建的设备句柄，释放资源。 - `SetupDiDestroyDeviceInfoList`: 销毁由`SetupDiGetClassDevs`创建的设备信息集，释放内存。 - `HidD_GetPreparsedData`: 获取设备的预解析数据，这是设备能力描述的缓存，有助于解析设备报告。 - `HidD_SetFeature`, `HidD_GetFeature`: 分别用于向设备发送特征报告和从设备接收特征报告。 3. **API使用示例** 通常，开发过程包括以下步骤： - 初始化：调用`HidD_GetHidGuid`获取HID设备的GUID。 - 设备搜索：通过`SetupDiGetClassDevs`查找系统中所有的HID设备。 - 接口枚举：使用`SetupDiEnumDeviceInterfaces`遍历设备接口，找到目标设备。 - 接口详细信息：调用`SetupDiGetDeviceInterfaceDetail`获取设备接口的详细信息，如设备路径。 - 打开设备：利用`CreateFile`根据设备路径创建设备句柄，准备进行I/O操作。 - 数据传输：使用`ReadFile`和`WriteFile`进行读写操作，实现与设备的通信。 - 特征报告：`HidD_SetFeature`和`HidD_GetFeature`用于与设备交换特征报告，进行特定功能的设置或查询。 - 清理：使用`CloseHandle`关闭设备句柄，`SetupDiDestroyDeviceInfoList`销毁设备信息集。 4. **注意事项** - 在调用API之前，确保正确设置了参数，例如`DeviceInterfaceData.cbSize`应设置为`sizeof(SP_DEVICE_INTERFACE_DATA)`。 - 处理错误：当API调用失败时，应检查`GetLastError`以获取错误代码，并进行相应的错误处理。 理解并熟练运用这些API和步骤，是成功开发VC HID应用的关键。通过这种方式，开发者可以与各种HID设备进行通信，例如键盘、鼠标、游戏控制器等，实现自定义的交互功能。