TTCE R800 动态库函数说明

根据给定的文件信息，我们可以总结出关于TTCE R800动态库接口函数的关键知识点。这份文档主要针对的是在Windows环境下使用的32位动态库，涵盖了如何与TTCE R800硬件设备进行交互的一系列接口函数。下面将详细介绍这些函数的功能、参数以及返回值等信息。 ### 一、动态库文件 #### WINDOWS动态库文件 1. **R500_USB_DLL.H** - 32位动态库的头文件，包含了动态库中的所有函数声明。 2. **R500_USB_DLL.LIB** - 32位动态库的输入库，用于链接器在编译过程中找到正确的动态库函数地址。 3. **R500_USB_DLL.DLL** - 实际的Windows 32位动态库文件，包含所有实际执行的代码。 ### 二、动态库函数 #### 打开关闭设备函数 1. **R500_USB_OpenRU** - **功能**：打开设备。 - **参数**：`[out] HidHandle` - 返回设备句柄。 - **返回值**：正确=0，失败=非0。 2. **R500_USB_CloseRU** - **功能**：关闭设备。 - **参数**：`[in] HidHandle` - 打开的设备句柄。 - **返回值**：正确=0，失败=非0。 #### 设备操作函数 1. **R500_USB_Reset** - **功能**：复位读卡器。 - **参数**： - `[in] HidHandle` - 设备句柄。 - `[out] _VerCode[20]` - 存储复位信息，若调用成功，则返回版本每个字符的ASCII值。 - **返回值**：正确=0，错误=非0（具体的错误代码参见文档最后的错误列表）。 2. **R500_USB_ResetAndEject** - **功能**：复位并弹卡。 - **参数**：`[in] HidHandle` - 设备句柄。 - **返回值**：正确=0，错误=非0（具体的错误代码参见文档最后的错误列表）。 3. **R500_USB_CheckCardPosition** - **功能**：读取卡片在机器里的位置。 - **参数**： - `[in] HidHandle` - 设备句柄。 - `[out] Postion` - 0x31表示有卡，0x30表示无卡。 - **返回值**：正确=0，错误=非0（具体的错误代码参见文档最后的错误列表）。 4. **R500_USB_Eject** - **功能**：弹卡。 - **参数**：`[in] HidHandle` - 设备句柄。 - **返回值**：正确=0，错误=非0（具体的错误代码参见文档最后的错误列表）。 5. **R500_USB_Led1Control** - **功能**：控制指示灯1。 - **参数**： - `[in] HidHandle` - 设备句柄。 - `[in] _PM` - 控制类型，其中0x30为熄灭指示灯，0x31为点亮指示灯，0x32为指示灯闪烁。 - **返回值**：正确=0，错误=非0（具体的错误代码参见文档最后的错误列表）。 6. **R500_USB_Led2Control** - **功能**：控制指示灯2。 - **参数**： - `[in] HidHandle` - 设备句柄。 - `[in] _PM` - 控制类型，其中0x30为熄灭指示灯，0x31为点亮指示灯，0x32为指示灯闪烁。 - **返回值**：正确=0，错误=非0（具体的错误代码参见文档最后的错误列表）。 #### 磁卡操作函数 1. **R500_USB_ReadMagcardDecode** - **功能**：读取磁卡解码后的数据。 - **参数**： - `[in] HidHandle` - 设备句柄。 - `[in] _track` - 要读取的轨道。 - `[out] _DataLen` - 返回数据的长度。 - `[out] _BlockData[]` - 磁卡数据包格式。读单轨、双轨或三轨格式的数据结构不同，具体格式如下： - 读单轨格式：`TR1_ST LEN 数据` - 读双轨格式：`TR1_ST LEN1 TR2_ST LEN2 TR1数据 TR2数据` - 读三轨格式：`TR1_ST LEN1 TR2_ST LEN2 TR3_ST LEN3 一轨数据 二轨数据 三轨数据` - 其中，`TR1_ST`、`TR2_ST`、`TR3_ST` 的取值需要参照文档说明。 以上是对TTCE R800动态库接口函数的主要功能介绍。这些函数提供了基本的操作支持，如设备的打开关闭、设备状态的检查、指示灯控制以及磁卡数据的读取等。通过这些函数，开发者可以方便地与TTCE R800硬件设备进行交互，并实现所需的功能。