杭州中正光学指纹采集仪开发手册.doc

一、产品介绍光学指纹采集仪是杭州中正生物认证技术有限公司(MIAXIS)研制的一款桌面应用型指纹产品，其特点是采集速度快，图像质量高，主要技术指标如下：〈1〉图像采集速度：8帧/S〈2〉图像精度：500DPI〈3〉图像大小：256*304像素〈4〉免驱动，在Win98以上Windows操作系统不需要安装USB驱动该指纹仪适用于各种基于PC的安全控制系统，如本机用户身份确认、局域网用户身份确认、各种应用系统用户身份确认等通过指纹来取代传统的密码，可增加系统的安全性和方便性与指纹仪配套的软件库如下：〈1〉MXOTDLL.dll包含Win32指纹仪驱动接口、指纹算法接口，实现指纹图像的采集、从指纹仪获取指纹特征、从指纹仪获取指纹模板、比对等功能适用于CS架构客户端程序〈2〉MXOTOCX.ocx包含指纹仪驱动接口、指纹算法接口，实现指纹图像的采集、从指纹仪获取指纹特征、从指纹仪获取指纹模板、比对等功能适用于BS架构浏览器端程序〈3〉MXOTFingerMatch.soUnix或Linux指纹比对算法动态库，实现比对功能适用于服务器端程序第#页共7页说明1、函数：intIsMxUsbDevice()^功能:是否正确连接参数：返回值：0－成功；-1－失败。

2、函数:intmxUsbGetImage(unsignedchar*imageBuf,longnTimeOut)功能:从指纹仪中，获取指纹图像参数:imageBuf－输出，指纹图像缓存，大小：256*304字节(二进制码)nTimeOut－输入，超时时间，单位：毫秒如果nTimeOut=0,则表示无限时等待返回值:0－成功；其他－失败失败说明:-1－打开指纹仪失败；-2－用户取消操作；-3－等待手指超时；-4－采集图像失败；-5－上传图像失败3、函数:voidmxCancelGetImage()功能:取消正在进行获取指纹图像操作4、函数:intIsMxGetImage()功能:是否正在进行获取指纹图像操作参数:返回值:0-是-1-否5、函数:voidmxGetDeviceVersion(charszVersion[256])功能:获取版本信息参数:szVersion-获取版本信息(256字节)返回值:6、函数:intmxWriteDevSN(char*pData,intnLength)功能:写设备序列号参数:pData-序列号,长度小于256字节nLength-序列号长度返回值:0-成功其他-失败7、函数:intmxReadDevSN(char*pData,int*nLength)功能:读设备序列号参数:pData-序列号,长度小于256字节nLength-序列号长度返回值:0-成功其他-失败8、函数：intmxRaw2Bmp(unsignedchar*pBmp,unsignedchar*pRaw,intX,intY)功能:原始图像数据，转换成bmp格式数据(包含文件头)参数：pBmp—bmp格式数据(大小：图像数据大小+1078)pRaw－原始图像数据X—图像宽度Y—图像高度返回：0—成功；非0—失败。

9、函数：intmxBmp2Raw(unsignedchar*pBmp,第#页共7页10、函数：unsignedintmxBase64Encode(unsignedchar*pInput,unsignedintinputLen,unsignedchar*pOutput,unsignedintoutputbufsize)功能:对数据块进行base64编码参数：plnput-输入，编码前数据块inputLen-输入，输入数据块（pInput）长度pOutput-输出，base64编码后数据块，大小为输入数据的4/3倍,输出数据块pInput和输入数据块pOutput起始地址可以相冋outputbufsize-输入，存放编码后数据（pOutput）的缓冲区大小返回：0-用于存放编码后数据的缓冲区不够，编码失败大于0-编码后数据长度，值为（inputLen+2）/3*411、函数:unsignedintmxBase64Decode(unsignedchar*pInput,unsignedintinputLen,unsignedchar*pOutput)功能：对输入的base64编码数据块进仃base64解码参数：plnput-输入，base64编码数据块inputLen-输入，base64编码数据块长度pOutput-输出，base64解码后的数据块输出数据块pInput和输入数据块pOutput起始地址可以相冋返回：0-用于存放编码后数据的缓冲区不够，编码失败。

大于0-编码后数据长度，值为（inputLen+2）/3*412、函数：intmxGetTzBase64(unsignedchar*input,unsignedchar*tzBuf)功能：从指纹图象中获取特征参数:input—输入，指纹图象缓冲，大小为256*304字节（二进制码）；tzBuf—输出，指针指向现场录入的指纹特征，344字节（Base64码）返回：0—获取特征成功；-1—获取特征失败13、函数：intmxGetMBBase64(unsignedchar*tzBufl,unsignedchar*tzBuf2,unsignedchar*tzBuf3,unsignedchar*mbBuf)功能：从三个指纹特征中合并指纹模板参数：tzBufl—输入，指向指纹特征1的指针，344字节（Base64码）；tzBuf2—输入，指向指纹特征2的指针，344字节（Base64码）；tzBuf3—输入，指向指纹特征3的指针，344字节（Base64码）；mbBuf—输出，指向指纹模板的指针，344字节（Base64码）返回：0—合并模板成功；-1—合并模板失败14、函数：intmxFingerMatchBase64(unsignedchar*mb,返unsignedchar*tz,intlevel)unsignedchar*pRaw,int*pW,int*pH）功能：bmp格式数据,转换成原始图像数据（不包含文件头）参数：pBmp—bmp格式数据（大小：图像数据大小+1078）pRaw－原始图像数据X—图像宽度Y—图像高度回：0—成功；非0—失败。

第#页共7页特征和指纹模板参数：mb—输入，指向指纹模板的指针，344字节（Base64码）；tz—输入^指指纹特征的指针，44字节（Hie64码level—输入，安全等级，1-5级，级别越高，越安全，一般取3返回：0—比对成功；-1—比对失败第#页共7页说明控件名:MXOTOCX.ocx类ID：4E16E1BD-B562-48E3-813E-DC5CA566D94C两点说明：1、采集指纹过程，可看到指纹图像，用于辅助判断所采集指纹图像的质量2、返回值为String的函数失败返回时，失败返回值为字符串，不是整型控件方法说明：1、函数：StringIsMxUsbDevice（）功能：是否正确连接设备参数：返回：成功：0失败：-12、函数：StringmxUsbGetImage（DWORDdwWaitTime）功能：获取指纹图像参数：dwWaitTime-输入，超时时间（单位：毫秒）返回：成功：指纹图像信息（指纹图像数据进行Base64编码后的字符串）;失败：-1－打开指纹仪失败；-2－用户取消操作；-3－等待手指超时；-4－采集图像失败；-5－上传图像失败3、函数：StringmxUsbGetTz（DWORDdwWaitTime）功能：获取指纹特征。

参数：dwWaitTime-输入，超时时间（单位：毫秒）返回：成功：指纹特征；失败：-1－打开指纹仪失败；-2－用户取消操作；-3－等待手指超时；-4－采集图像失败；-5－上传图像失败；-6－提取指纹特征失败4、函数：StringmxUsbGetMb（DWORDdwWaitTime）功能：获取指纹模板参数：dwWaitTime-输入，超时时间（单位：毫秒）返回：成功：指纹模板；失败：-1－打开指纹仪失败；-2－用户取消操作；-3－等待手指超时；-4－采集图像失败；-5－上传图像失败；-6－提取指纹特征失败；-7－合并指纹模板失败5、函数：intmxFingerMatch（char*mb,char*tz,intlevel）功能：指纹比对参数：mb-输入，指向指纹模板的指针，256字节（Base64码）；tz-输入，指向指纹特征的指针，344字节（Base64码）；level-输入，安全等级，1-5级，级别越高，越安全，一般取3返回：0-比对成功；第#页共7页M.AXI比对失败6、函数：StringmxGetDeviceVersion()功能:获取版本信息参数：返回值:版本信息7、函数:StringmxGetDeviceSN()功能:获取设备序列号参数:返回值:成功：设备序列号失败：-1打开设备失败-2写入操作失败8、函数:shortmxSetDeviceSN(char*szDevSN,shortnLength)功能:获取版本信息参数:szDevSN-输入，设备序列号，长度小于256字节nLength-输入，设备序列号长度返回值：o-成功其他-失败第#页共7页.so接口说明函数：unsignedintmxFingerMatchBase64(unsignedchar*mb,unsignedchar*tz,intlevel)功能：指纹比对。

参数：mb-输入，指向指纹模板的指针，344字节（Base64码）；tz-输入，指向指纹特征的指针，344字节（Base64码）；Level-输入，安全等级，1-5级，级别越高，越安全，一般取3返回：0-比对成功；非0-比对失败第#页共7页。