GA_T 1486-2018安全防范 虹膜识别应用 程序接口规范.pdf

ICS_13.310A 91GA中华人民共和国公共安全行业标准GA/T 1486—2018安全防范虹膜识别应用程序接口规范Security protection-—Iris recognition applications-Specifications for programming interface2018-05-07发布2018-05-07实施中华人民共和国公安部发布 GA/T 1486—2018目次前言1范围2规范性引用文件3术语和定义4基本要求4.1基本约定4.2接口发布方式5数据类型5.1采集设备信息5.2图像数据5.3采集图像信息5.4虹膜识别图像信息5.5人眼区域位置函数定义6.1采集设备接口函数6.2识别算法接口函数..10附录A(规范性附录)链接库文件名称附录B（资料性附录）程序接口调用流程示例8附录C(规范性附录)接口函数错误代码含义2 GA/T 1486—2018表8IR_Dev_Open数参数参数数据类型函数调用类型参数说明pDevicelnfo虹膜采集设各信息数据类型指针输人参数指定的虹膜采集设备pDeviceHandle无类型指针的指针输出参数打开设备获取的句柄，内存由链接库内部管理关闭指定设备用于关闭指定虹膜采集设备的函数，函数原型：int IR_Dev_Close(void pDeviceHandle) ;函数参数：见表9.返回值：成功返回0，否则返回错误代码。表 9IR_Dev_Close函数参数参数数据类型函数调用类量参数说明pDevice Handle无类型指针输入参数雷要关闭的设备的句柄单次采集图像用于使用打开的指定虹膜采集设备单次采集虹膜图像的函数。函数原型：int IR_Dev_Capturelmage(void pDeviceHandle, CAPTUREIMG* pCapturelmg,int plmgNum) ;西数参数：见表10.返回值：成功返回0，香则返回错误代码，表10IR_Dev_Capturelmage数参数参数数据类型函数调用类型参数说明pDevice Handle无类型指针输人参数需要采集图像的设备句辆pCapturelmg采集图像信息指针的指针输出参数虹膜采集设备采集的图像信息虹膜采集设备采集的图像数量。输人时表示pCapturelmg参数中预分配的plmgNum采集的图像信息数量输入输出参数图像单元空间数量，输出时表示pCap-turelmg参数中实际有效的图像单元空间数量6.1,3.7连续采集图像用于开始连续采集图像的函数。函数原型；int IR_Dev_StartRealCapture(void pDeviceHandle, IRREALDATACALLBACKcbFunc, void pUserData);函数参数：见表11， GA/T 1486—2018返回值：成功返回0，否则返回错误代码。表 11IR_Dev_StartRealCapture画数参数参数据类型函数消用类型参数说明pDeviceHandle无类型指针输人参数打开的虹膜采集设备句柄cbFunc码国调函数输人参数码流数据回调函数pUserData无类型指针输人参数用户自定义数据，该值将通过IRREALDATACALLBACK 传递给外部使用连续采集图像回调函数用于获取连续采集图像的回调函数。函数原型：typedef void(CALLBACK IRREALDATACALLBACK) (CAPTUREIMG* pCapturelmg, int nlmgNum , void pUserData) ;函数参数：见表12.表12IRREALDATACALLBACK函数参数参数数据类型西数调用类型参数说明pCapturelmg虹膜采集图像信息数据指针的指针输人参数虹膜采集设备采集的图像信息；内存由链换库内部管理nlmgNum32位整型输入参数虹膜采集设备单次采集输出的图像数量pUserDsta无类型指针输入参数用户自定义数据，该值通过IR_Dev_StartRealCapture函数传递至链接库内部停止连续采集图像用于停止传输虹膜采集设备码流的函数。函数原型：int IR_Dev_StopRealCapture(void pDeviceHandle) ;函数参数：见表13，返回值；成功返国0，否则返回错误代码，表13IR_Dev_StopRealCapture画数参数参数数据类型函数调用类型参数说明pDeviceHandle无类型指计输入参数打开的虹膜采集设各句柄6.1,3,10取得接口返回结果的错误信息用于根据错误代码获取错误信息的函数，接口函数错误代码含义见附录C。函数原型：int IR_Dev_GetErrorInfo(int nErrorNo,char eErrorInfo[256]