HX-DXQ20型IC卡读写器动态链接库函数使用手册.docVIP

HX-DXQ 2.0型IC卡读写器 动态链接库函数使用手册 版本 V 2.4 华旭金卡股份有限公司 2004年4月 第一章 概述 一、运行环境 本函数库（hxdxq_711.Dll, hxdxq_711.LIB）是针对我公司产品HX-DXQ 2.0型IC卡读写器开发的动态链接库，为32位Windows动态函数库，可用于Windows95/98/2000及 WindowsNT4.0以上环境。 二、安装步骤 串口读写器 按照串口读写器使用手册说明，将串口读写器同PC机串口相连。 USB口读写器 按照USB读写器使用手册说明，将USB读写器同PC机USB口相连。并进行硬件系统安装。 三、函数库说明 本函数库包含读写器设备操作函数组、IC卡操作函数组、数据处理函数组，IO操作卡函数组，SPI协议卡操作函数组，可供由Visual Basic、PowerBuilder、Microsoft C/C++ 、Delphi、Visual Foxpro等应用平台开发IC卡管理系统的软件接口，本手册附后提供调试通过的上述平台上的调用例子，仅供参考。 1、函数调用参数类型说明 BYTE： 字节，取值范围：0到255； WORD： 双字节，取值范围：0到65535； DWORD：四字节，取值范围：0到4294967295； int 带符号的整型数，取值范围：-32768到 +32768； 注意：凡调用函数要求返回数据的，其数据缓冲区均由调用者提供，并应确保数据缓冲区的容量足够大（参见相关函数的说明）。 2、函数的返回值 所有函数均返回一个有符号整型数（int），该符号整型数值分配如下： -1: 调用参数错。 0： 函数调用成功，过程正常结束。 1~254 读写器级错误或故障。 255 函数调用失败、IC卡操作过程失败。 具体请参见附录一的函数返回详细定义及说明。 第二章 动态链接库函数详细说明 一、读写器设备操作函数组 （1）、连接设备函数 功能： 选择或自动识别读写器连接的端口（串口或USB口），初始化并连接串口或USB口。采用选择方式时，读写器物理连接到那个串口或USB口，即应选择那个串口或USB口，必须一致。使用读写器应首先调用此函数选择串口或USB口，才能正确使用其他函数。 选择自动识别读写器时，应确保只有一个读写器与系统相连，当有多个读写器与系统相连时，自动识别仅能识别一个读写器（识别顺序为先USB，后串口）。 格式： int LinkDevice(char DeviceName[]); 参数： char DeviceName[]。 指示要连接的端口名称。如COM1,COM2,HXUSB。 自动识别时，指定此参数为AUTO 返回值：指示函数执行的结果。0表示成功；非0表示出错，见附录。 例： int ret; ret = LinkDevice(“AUTO”); （2）、设置当前活动读写器 功能：华旭读写器动态库可以支持在一个应用中同时对多个读写器操作，使用此函数设置当前活动读写器。 格式：int SetActiveReader(char devicename[]); 参数：char devicename[]。连接的端口名称。如COM1,COM2,HXUSB。 返回值：指示函数执行的结果。0表示成功；非0表示出错，见附录。 （3）、获取当前活动读写器连接端口名称 功能：获取与当前活动读写器连接端口的名称。 格式：int GetDeviceName(char devicename[]) 参数：char devicename[]。 返回与当前活动读写器连接的端口名称。 返回值：指示函数执行的结果。0表示成功；非0表示出错，见附录。 （3）、断开设备函数 功能：断开已连接的串口或USB口，释放系统资源。一般在使用完读写器或退出应用时， 应调用此函数。 格式： int UnlinkDevice(void) 参数： 空。 返回值：指示函数执行的结果。0表示成功；非0表示出错，见附录。 例： int ret; ret = UnlinkDevice(); （4）、复位读写器函数 功能： 复位读写器，读写器复位后自动返回自己的复位信息（最多14字节），主机根据ATR 信息自动调整与读写器的通信参数。并一直保持到断开连接，读写器与PC的串口通信速率设置为9600BPS. 格式： int Reset_Device(BYTE recedata[], DWORD* plen)； 参数： BYTE recedata[] 返回12个字节的复位应答信息和SW，要求不小于16 字节。 DWORD* plen rece