《hx-dxq 2.0型ic卡读写器动态链接库函数使用手册》由会员分享，可在线阅读，更多相关《hx-dxq 2.0型ic卡读写器动态链接库函数使用手册（47页珍藏版）》请在金锄头文库上搜索。
1、HX-DXQ 2.0型 IC卡读写器动态链接库函数使用手册版本 V 2.4华旭金卡股份有限公司2004年 4月HX-DXQ 2.0 型 IC 卡读写器动态链接库函数使用手册2第一章 概述一、运行环境本函数库（hxdxq_711.Dll, hxdxq_711.LIB）是针对我公司产品 HX-DXQ 2.0型 IC卡读写器开发的动态链接库，为 32位 Windows动态函数库，可用于 Windows95/98/2000及 WindowsNT4.0以上环境。二、安装步骤1、串口读写器按照串口读写器使用手册说明，将串口读写器同 PC机串口相连。2、USB 口读写器按照 USB读写器使用手册说明，将 U
2、SB读写器同 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
3、 带符号的整型数，取值范围：-32768 到 +32768；注意：凡调用函数要求返回数据的，其数据缓冲区均由调用者提供，并应确保数据缓冲区的容量足够大（参见相关函数的说明）。2、函数的返回值所有函数均返回一个有符号整型数（int），该符号整型数值分配如下：-1: 调用参数错。 0： 函数调用成功，过程正常结束。1254 读写器级错误或故障。255 函数调用失败、IC 卡操作过程失败。具体请参见附录一的函数返回详细定义及说明。第二章 动态链接库函数详细说明一、读写器设备操作函数组（1）、连接设备函数功能：HX-DXQ 2.0 型 IC 卡读写器动态链接库函数使用手册3选择或自动识别读写器连接的端
4、口（串口或 USB 口），初始化并连接串口或 USB 口。采用选择方式时，读写器物理连接到那个串口或 USB 口，即应选择那个串口或 USB 口，必须一致。使用读写器应首先调用此函数选择串口或 USB 口，才能正确使用其他函数。选择自动识别读写器时，应确保只有一个读写器与系统相连，当有多个读写器与系统相连时，自动识别仅能识别一个读写器（识别顺序为先 USB，后串口）。格式： int LinkDevice(char DeviceName);参数： char DeviceName。 指示要连接的端口名称。如 COM1,COM2,HXUSB。自动识别时，指定此参数为 AUTO返回值：指示函数执行的结
5、果。0 表示成功；非 0表示出错，见附录。 例： int ret;ret = LinkDevice(“AUTO”);（2）、设置当前活动读写器功能：华旭读写器动态库可以支持在一个应用中同时对多个读写器操作，使用此函数设置当前活动读写器。格式：int SetActiveReader(char devicename);参数：char devicename。连接的端口名称。如 COM1,COM2,HXUSB。返回值：指示函数执行的结果。0 表示成功；非 0表示出错，见附录。（3）、获取当前活动读写器连接端口名称功能：获取与当前活动读写器连接端口的名称。格式：int GetDeviceName(cha
6、r devicename)参数：char devicename。 返回与当前活动读写器连接的端口名称。返回值：指示函数执行的结果。0 表示成功；非 0表示出错，见附录。 （3）、断开设备函数功能：断开已连接的串口或 USB口，释放系统资源。一般在使用完读写器或退出应用时， 应调用此函数。格式： int UnlinkDevice(void)参数： 空。返回值：指示函数执行的结果。0 表示成功；非 0表示出错，见附录。 例： int ret;ret = UnlinkDevice();（4）、复位读写器函数功能： 复位读写器，读写器复位后自动返回自己的复位信息（最多 14字节），主机根据ATR 信息
7、自动调整与读写器的通信参数。并一直保持到断开连接，读写器与 PC的串口通信速率设置为 9600BPS.格式： int Reset_Device(BYTE recedata, DWORD* plen)；参数： BYTE recedata 返回 12个字节的复位应答信息和 SW，要求不小于 16 字节。HX-DXQ 2.0 型 IC 卡读写器动态链接库函数使用手册4DWORD* plen receddata中返回数据长度. 返回值：SW 见统一定义，下面全部函数同此。（5）、置读写器通讯速率函数功能： 调整与接口设备的通信参数。并一直保持到下次重置或断开连接(该函数仅对串口有效，对 USB口无效)
8、。格式： int SetDeviceParm(BYTE speedno, BYTE recedata, DWORD* plen)；参数： BYTE speedno （07），具体含义如下：通讯速率 0/4800 1/9600 2/14400 3/19200 4/28800 5/38400 6/57600 7/115200BYTE recedata SWDWORD* plen receddata中返回数据长度。 返回值：SW 见统一定义，下面全部函数同此。（6）、查询读写器函数功能： 查询读写器状态，正工作的卡槽号，能支持的卡槽数，和已插卡的卡槽号。格式： int QueryDevice(BYT
9、E recedata, DWORD* plen)；参数： BYTE recedata 返回的读写器信息和 SW。读写器信息不超过 16个字节，依次为读写器类型（包括卡槽上电状态）、能支持的卡槽数和已插卡的卡槽号。DWORD* plen receddata中返回数据长度。返回值：SW 见统一定义，下面全部函数同此。（7）、查询插卡函数功能： 查询读写器有无插卡。格式： int QueryCard(BYTE recedata, DWORD* plen)；参数： BYTE recedata 返回的插卡信息（包括卡槽上电状态）和 SW共 4个字节。 DWORD* plen receddata中返回数据
10、长度。返回值：SW 见统一定义，下面全部函数同此。二、IC 卡操作函数组（1）、卡加电函数功能： 给卡加电复位。卡加电复位后自动返回卡的 ATR 信息(CPU 卡)或卡型(能识别的逻辑加密卡)，读写器根据 ATR 信息自动调整与卡的通信参数和设置卡类。并一直保持到卡去电。(对存储卡，请调用 SetCardTypeDevice函数对卡片上电)格式： int PowerOn(BYTE slot, BYTE recedata, DWORD* plen)；参数： BYTE slot slot指定要加电的卡槽号。BYTE recedata 返回最多 32个字节的复位应答信息或能识别的 Memory卡型值
11、和 SW，要求不小于 34 字节。DWORD* plen receddata中返回数据长度. 返回值：SW 见统一定义，下面全部函数同此。HX-DXQ 2.0 型 IC 卡读写器动态链接库函数使用手册5（2）、设定卡类型函数功能：指定插入读写器卡槽中的卡类型。对调用卡加电函数能识别的卡型，就不必再调用此函数。对 CPU卡和逻辑加密卡均可自动识别卡型，对存储卡不能识别其卡型。格式：int SetCardTypeDevice(BYTE slot,BYTE cardkind, BYTE cardtype,BYTE recedata, DWORD* plen)；参数： BYTE slot 卡槽号BYT
12、E cardkind CPU卡(1)或非 CPU卡(2)BYTE cardtype 见后卡型统一定义 BYTE recedata 返回 SW，要求不小于 2 字节。DWORD* plen receddata中返回数据长度. 说明： 对于 CryptoMemory卡，cardkind 应设置为 1(CPU卡)(3)、卡去电函数功能： 对指定卡槽中已加电卡的去电, 一般在一张卡操作全部完成后拔卡前去电。去电后卡核对密码正确的影响即失效。格式： int PowerOff(BYTE slot,BYTE recedata, DWORD* plen)；参数： BYTE slot 读卡器的槽号BYTE re
13、cedata 返回的 SW，要求不小于 2 字节DWORD* plen receddata中返回数据长度.非 CPU卡（逻辑加密卡和存储卡）命令函数(4)、字节读函数功能：按指定的字节区号、地址、长度，读取卡中的数据。对于有读保护功能的卡，读前应先核对相应的读密码。只有正确核对密码后才能正确读出需要的数据。如果没有核对密码或核对不正确，读操作仍能进行，但读出的内容肯定不正确。格式：int ReadCard(WORD zone,WORD addr, WORD len, BYTE recedata,DWORD* plen)；参数：WORD zone 要读卡的区号或块号WORD addr 要读的起始
14、字节地址。WORD len 要读的数据的字节数。BYTE recedata 存放返回的数据和 SW，要求不小于 len+2字节。DWORD* plen receddata中返回数据长度. 具体卡的分区、地址值见附录。(5)、字节写函数功能： 按指定卡的字节区号、地址、长度，更新卡中的数据。写卡注意一点：逻辑加密卡，只有正确核对密码后才能正确写卡。如果没有核对密码或核对不正确，写操作仍能进行，但内容肯定写不进去。所以写的内容最好读出核对一下。HX-DXQ 2.0 型 IC 卡读写器动态链接库函数使用手册6格式： int WriteCard(WORD zone,WORD addr, WORD le
15、n, BYTE senddata,BYTE recedata, DWORD* plen)；参数：WORD zone 要写卡的区号或块号.WORD addr 要写的起始字节地址WORD len 要写的数据的字节数.BYTE senddata 要写的数据BYTE recedata 存放返回的 SW，要求不小于 2 字节DWORD* plen receddata中返回数据长度. 具体卡的分区、地址值见附录。(4)、AT1024K 卡字节读函数功能：按指定的字节区号、地址、长度，读取卡中的数据。对于有读保护功能的卡，读前应先核对相应的读密码。只有正确核对密码后才能正确读出需要的数据。如果没有核对密码或核对不正确，读操作仍能进行，但读出的内容肯定不正确。格式：int ReadCard_Ex(WORD zone,DWORD addr, DWORD len, BYTE recedata,DWORD* plen)；参数：WORD zone 要读卡的区号或块号DWORD addr 要读的起始字节地址。DWORD len 要读的数据的字节数。BYTE recedata
