CyAPI使用指南文档

简介：
《CyAPI使用指南文档》旨在为开发者提供详细的指导与示例代码，帮助其快速掌握CyAPI接口调用方法及最佳实践技巧。 CyAPI原版资料表明,CyAPI.lib提供了一种简单而强大的C++编程接口用于USB设备的交互操作。更确切地说,它是一个针对CyUsb3.sys设备驱动程序提供的高级别编程接口的C++类库，只能与由该驱动服务（即绑定到）的USB设备进行通信。应用程序可以通过调用简单的 CyAPI 方法如Open、Close和XferData来实现与这些 USB 设备的交互操作,而不是通过Windows API 调用来访问此驱动程序。 使用此库时，您需要在引用CCyUSBDevice类的文件中包含头文件CyAPI.h，并且必须将静态链接的 CyAPI.lib 文件链接到您的项目。Microsoft Visual Studio 2008版本已提供相应的 .lib 文件供使用。该库采用设备和端点模型进行操作。 要使用此库，您需要通过 new 关键字创建 CCyUSBDevice 类的一个实例。CCyUSBDevice 对象可以知道有多少个 USB 设备连接到了 CyUsb3.sys 驱动程序，并且可以通过调用 Open 方法将这些设备中的任何一个抽象出来供其访问。一个 CCyUSBDevice 实例会暴露许多特定于该设备的方法和数据成员，例如 DeviceName、DevClass、VendorID、ProductID 和 SetAltIntfc。 当CCyUSBDevice对象连接到某个已附接的 USB 设备时,它的端点成员提供了与这些设备端点进行数据传输接口。每个端点特有的数据成员及方法如MaxPktSize，TimeOut，bIn，Reset和XferData只能通过 CCyUSBDevice 对象的端点属性来访问。 除了其简洁性外，此类库还支持创建复杂的应用程序。CCyUSBDevice构造函数会自动注册您的应用以接收Windows USB即插即用事件通知,这使您能够实现实时设备插入功能。“hot plugging”允许用户在不关闭程序的情况下连接或断开硬件设备。 另外，异步的 BeginDataXfer/WaitForXfer/FinishDataXfer 方法可以将多个数据传输请求排队到一个端点上，从而实现从应用程序级别进行高性能的数据流处理。