VC HID开发笔记

1、头文件包含,库文件链接

 在VC中开发HID应用程序时,需要包含setupapi.h和hidsdi.h,包含方式必须为extern "C",如下所示:

extern "C" {
// Declare the C libraries used
#include "setupapi.h"  // Must link in setupapi.lib
#include "hidsdi.h"   // Must link in hid.lib
}

然后在setting—>Link—>object/libary modules 中添加setupapi.lib hid.lib 两个库文件。

 

2、Windows操作HID设备的API

API函数

DLL

功能

HidD_GetHidGuid

Hid.dll

取得类别

SetupDiGetClassDevs

Setupapi.dll

获取一个设备信息群,包含指定类的所有设备

SetupDiEnumDeviceInterfaces

Setupapi.dll

获取信息群内一个设备的信息

SetupDiGetDeviceInterfaceDetail

Setupapi.dll

获取设备路径

HidD_GetAttributes

Hid.dll

获取厂商与产品,版本号

HidP_GetValueCaps

Hid.dll

获取描述设备能力的结构

CreateFile

ReadFile

Kernel32.dll

Kernel32.dl

开启设备通信

从设备读取一个报文

WriteFile

Kernel32.dll

发送一个报文给设备

CloseHandle

Kernel32.dll

释放CreateFile创建的资源

SetupDiDestroyDeviceInfoList

Setupapi.dll

释放SetupDiGetClassDevs使用的资源

HidD_GetPreparsedData

Hid.dll

获取保存设备能力信息的缓冲器的句柄

HidD_SetFeature

Hid.dll

发送一个特征报文给设备

HidD_GetFeature

Hid.dll

从设备获取特征报文

 

 void __stdcall HidD_GetHidGuid(
  __out  LPGUID HidGuid    //指针指向调用者分配的GUID的内存区域,通常返回HID设备的GUID
);

 

HDEVINFO SetupDiGetClassDevs(
  __in_opt  const GUID *ClassGuid,// 一个特定类别GUID的指针
  __in_opt  PCTSTR Enumerator,     //过滤梅举的内容
  __in_opt  HWND hwndParent,        //用于关联到集合成员中的用户接口的顶层窗口句柄
  __in      DWORD Flags                      //建立设备信息表的控制选项,DIGCF_PRESENT(当前存在的设备)DIGCF_ALLCLASSES(所有设备)DIGCF_PROFILE(当前硬件概况);

如成功,返回包含所有与指定参数匹配的已经安装设备信息句柄,否则返回INVALID_HANDLE_VALUE

 

BOOL SetupDiEnumDeviceInterfaces(
  __in      HDEVINFO DeviceInfoSet,  //一个指向设备信息集合的句柄,包含设备接口返回信息,通常是SetupDiGetClassDevs的返回
  __in_opt  PSP_DEVINFO_DATA DeviceInfoData,  //指向特定设备的SP_DEVINFO_DATA 类型的指针,
  __in      const GUID *InterfaceClassGuid, //指向制定设备接口类的GUID指针
  __in      DWORD MemberIndex,  //设备信息中接口列表的索引值(初始值为0)
  __out     PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData //指向调用者分配的SP_DEVICE_INTERFACE_DATA类型的内存区域的指针,调用前必须先配置DeviceInterfaceData.cbSize = sizeof(SP_DEVICE_INTERFACE_DATA)
);

如成功,返回TRUE,否则返回FALSE,并可以调用GetLastError(void)获取错误信息

 

BOOL SetupDiGetDeviceInterfaceDetail(
  __in       HDEVINFO DeviceInfoSet,  //一个指向设备信息集合的句柄,包含设备接口返回信息,通常是SetupDiGetClassDevs的返回
  __in       PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,  //指向SP_DEVICE_INTERFACE_DATA类型的内存区域的指针,SetupDiEnumDeviceInterfaces的返回
  __out_opt  PSP_DEVICE_INTERFACE_DETAIL_DATA DeviceInterfaceDetailData,//SP_DEVICE_INTERFACE_DETAIL_DATA 类型指针,用于获取路径,调用前必须先配置DeviceInterfaceDetailData.cbSize =sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA)
  __in       DWORD DeviceInterfaceDetailDataSize, //DeviceInterfaceDetailData 的长度,
  __out_opt  PDWORD RequiredSize, //DeviceInterfaceDetailData 的实际长度
  __out_opt  PSP_DEVINFO_DATA DeviceInfoData  //PSP_DEVINFO_DATA 类型的指针,存放支持的设备接口信息,DeviceInfoData.cbSize =sizeof(SP_DEVINFO_DATA)
);

如成功,返回TRUE,否则返回FALSE,并可以调用GetLastError(void)获取错误信息

 

BOOLEAN __stdcall HidD_GetAttributes(
  __in   HANDLE HidDeviceObject,  //HID设备句柄
  __out  PHIDD_ATTRIBUTES Attributes  //HIDD_ATTRIBUTES类型指针
);

 HANDLE WINAPI CreateFile(
  __in      LPCTSTR lpFileName,  //已打开的设备名称
  __in      DWORD dwDesiredAccess, //操作权限,GENERIC_READ(读模式), GENERIC_WRITE(写模式), 或者both
  __in      DWORD dwShareMode,  //共享模式,0(禁止访问),FILE_SHARE_DELETE(删除),FILE_SHARE_READ(读),FILE_SHARE_WRITE(写)

 __in_opt  LPSECURITY_ATTRIBUTES lpSecurityAttributes,  //SECURITY_ATTRIBUTES 类型指针
  __in      DWORD dwCreationDisposition, //打开方式,对于设备来说经常设为 OPEN_EXISTING
  __in      DWORD dwFlagsAndAttributes,  //设备属性和标识,经常设为FILE_ATTRIBUTE_NORMAL
  __in_opt  HANDLE hTemplateFile  //模板文件句柄
);

如成功,则返回一个文件或设备的句柄

 

BOOL WINAPI ReadFile(
  __in         HANDLE hFile,  //文件或设备的句柄
  __out        LPVOID lpBuffer,    //存放读取数据的指针

   __in         DWORD nNumberOfBytesToRead,  //读取数据长度的最大值
  __out_opt    LPDWORD lpNumberOfBytesRead,  //读取数据的实际长度
  __inout_opt  LPOVERLAPPED lpOverlapped //OVERLAPPED 类型指针,如果该设备或文件被重复打开,需要传入次参数
);

如成功,返回TRUE,否则返回FALSE,并可以调用GetLastError(void)获取错误信息

 

BOOL WINAPI WriteFile(
  __in         HANDLE hFile,  //文件或设备的句柄
  __in         LPCVOID lpBuffer,  //存放写入数据的指针
  __in         DWORD nNumberOfBytesToWrite,    //写入数据长度的最大值
  __out_opt    LPDWORD lpNumberOfBytesWritten,   //写入数据的实际长度
  __inout_opt  LPOVERLAPPED lpOverlapped  //OVERLAPPED 类型指针,如果该设备或文件被重复打开,需要传入次参数
);

如成功,返回TRUE,否则返回FALSE,并可以调用GetLastError(void)获取错误信息

 

BOOL SetupDiDestroyDeviceInfoList( __in  HDEVINFO DeviceInfoSet);  //释放SetupDiGetClassDevs使用的资源

 

3、代码示例

 打开一个指定VendorID和ProductID的HID设备

PSP_DEVICE_INTERFACE_DETAIL_DATA HID_FindDevices(USHORT V_ID, USHORT P_ID, unsigned short *FIFO_Length)
{
 GUID                             HidGuid;
 HDEVINFO                         DevInfo;
 HIDD_ATTRIBUTES      DevAttributes;
 SP_DEVICE_INTERFACE_DATA         DevData;
 PSP_DEVICE_INTERFACE_DETAIL_DATA DevDetail;
 PHIDP_PREPARSED_DATA          PreparsedData;
 HIDP_CAPS                   Capabilities;
 ULONG                            Length;
 int                              Index;
 
 BOOL                             ok;
 HANDLE DevHandle;
 int DevCount = 0;
 /* Get GUID for all System HIDs */

 HidD_GetHidGuid(&HidGuid);

 /* Get Device Information for all present devices */
 DevInfo = SetupDiGetClassDevs(&HidGuid,
  NULL,
  NULL,
  (DIGCF_PRESENT | DIGCF_DEVICEINTERFACE)
  );

 DevData.cbSize = sizeof(DevData);

 DevDetail = NULL;

 Index = -1;
 *FIFO_Length = 0;
 /* Scan all Devices */
 do {

  Index++;

  /* Device Interface Element of a Device Information set */
  ok = SetupDiEnumDeviceInterfaces(DevInfo,
   0,
   &HidGuid,
   Index,
   &DevData
   );
  if (!ok) break;

  /* Get Device Interface Details - Get Length */
  ok = SetupDiGetDeviceInterfaceDetail(DevInfo,
   &DevData,
   NULL,
   0,
   &Length,
   NULL
   );
  
  /* Allocate memory for Device Detailed Data */
  DevDetail = (PSP_DEVICE_INTERFACE_DETAIL_DATA) malloc(Length);

  /* Set cbSize in the DevDetail structure */
  DevDetail->cbSize = sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA);

  /* Get Device Interface Details */
  ok = SetupDiGetDeviceInterfaceDetail(DevInfo,
   &DevData,
   DevDetail,
   Length,
   NULL,
   NULL
   );
  if (!ok)
  {
   free(DevDetail);
   DevDetail = NULL;
   continue;
  }
  
  /* Create File for Device Read/Write */
  DevHandle = CreateFile(DevDetail->DevicePath,
   GENERIC_READ | GENERIC_WRITE,
   FILE_SHARE_READ | FILE_SHARE_WRITE,
   (LPSECURITY_ATTRIBUTES)NULL,
   OPEN_EXISTING,
   0,
   NULL
   );

  if (DevHandle == INVALID_HANDLE_VALUE)
  {
   free(DevDetail);
   DevDetail = NULL;
   continue;
  }

  DevAttributes.Size = sizeof(DevAttributes);
  ok = HidD_GetAttributes(DevHandle,&DevAttributes);
  if(!ok)
  {
   free(DevDetail);
   CloseHandle(DevHandle);
   DevDetail = NULL;
   continue;
  }
  if(DevAttributes.VendorID!=V_ID||DevAttributes.ProductID != P_ID)
  {
   free(DevDetail);
   CloseHandle(DevHandle);
   DevDetail = NULL;
   continue;
  }
  /* Get Preparsed Data */
  ok = HidD_GetPreparsedData(DevHandle, &PreparsedData);
  if (!ok)
  {
   free(DevDetail);
   CloseHandle(DevHandle);
   DevDetail = NULL;
   continue;
  }

  /* Get Device's Capabilities */
  HidP_GetCaps(PreparsedData, &Capabilities);
  *FIFO_Length = Capabilities.InputReportByteLength;
  

  CloseHandle (DevHandle);
  break;

 } while (DevCount < 20);
 SetupDiDestroyDeviceInfoList (DevInfo);

 return DevDetail;

}

 

相关推荐
史上最全USB HID开发资料,悉心整理一个月,亲自测试。 涉及STM32 C51 8051F例子都有源码,VC上位机例子以及源码,USB协议,HID协议,USB抓包工具,开发文档,开发过程文档。 详细内容就不都说了,看目录。 有了这个资料包,你再说开发不了USB HID,打死我都不信! 好资料当然一分都不能少! 目录: STM32_USB_HID_PC_demo:USB HID Demonstrator Release软件和文档 STM32_USB_HID_分析:STM32 USB HID 固件学习分析 STM32_USB_HID_例子:STM32 USB HID方式收发例子。 STM32_USB_HID_学习心得:基于STM32 的USB程序开发笔记、修改STM32的USB例程为自己所用、初涉USB,初学者USB入门总结——枚举。 STM32_固件库说明文档:STM32_USB_Demo例子的中文说明文档。 STM32F107 鼠标USB改 HID数据发送程序。 USB_HID_8051F例子。 USB_HID_C51源码。 USB_HID_PC_源码:PC端打开HID设备、读写操作实例。 USB_HID_PC接收发送工具:用于调试USB HID设备,就相当于串口工具啦。自己写好了HID设备,用它接收发送调试非常方便。 USB_HID_PC通信详解:PC端HID读写操作说明。 USB_HID_VC++6.0_入门级例子:简单读写USB HID设备,很好的参考作用。 USB_HID_VC++6.0_入门级例子开发步骤(图解说明,真详细啊!):一步一步手把把手教你开发VC++6.0 USB HID程序。 USB_HID_VC++6.0读写设备源码:简单打开HID设备,读写源码,参考的好例子。 USB_HID_VC++6.0源码:出具雏形的VC++6.0 USB HID 工具源码。非常完善了,可以直接当工具使用,关键是有源码! USB_HID_开发过程详细说明:长篇论文一篇,详细说明HID开发过程,包括下位机、上位机、HID驱动的开发,牛! USB_HID协议(英文)。 USB_STM32_HID开发笔记:里面有USB设备枚举的详细过程,抓包说明的哦。当然包括开发过程啦。令牌包、握手包、数据包中的数据都看得到。 USB_URB分析:抓包工具抓到的数据包的详细解析。 USB_VC教程:短论文一篇,用VC++编写USB接口通信程序,简洁扼要说明VC++6.0开发步骤,提纲挈领,值得一看! USB2.0协议(英文)。 USB技术规范(中文):中文的USB技术规范说明,中文的! USB抓包软件:两种抓包工具,bushound和usbtrace。都是破解版,哈哈,自己偷着乐吧! 深入解析STM32_USB库:STM32 USB的库说明。
©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页