身份證閱讀器SDK使用說明

-.z.閱讀器SDK使用說明〔V1.3〕華視電子讀寫設備目錄TOC\o"2-3"\h\z\t"標題1,1"版本變更記錄11閱讀器SDK簡介12系統(tǒng)需求13函數說明13.1核心相關函數13.2獲取具體信息函數23.3人證比對相關函數33.4函數調用流程34閱讀器SDK44.1文件夾組成44.2身份閱讀器SDK的使用5使用方法5使用限制54.3閱讀器SDK測試程序5-.z.版本變更記錄序號創(chuàng)立/變更時間變更緣由版本號變更人審核人批準人12011/07/29創(chuàng)立艷22011/08/04增加新接口〔見3.3節(jié)〕艷32011/08/054.2節(jié)加授權說明艷42011/08/08添加GetManuID函數艷52011/08/10添加CVR_Ant函數艷62011/09/01修改授權方式(見4.2.2)艷72011/09/08修改授權方式(見4.2.2)艷82011/09/19修改授權方式(見4.2.2)艷閱讀器SDK簡介本文檔描述了華視閱讀器SDK〔Windows版〕的調用方法、函數定義、參數和返回值說明，供開發(fā)商進展二次開發(fā)使用。系統(tǒng)需求〔1〕操作系統(tǒng)：Windows*P〔2〕開發(fā)環(huán)境：本SDK采用ANSIC語言編寫，假定用戶采用C/C++語言作為開發(fā)工具。函數說明核心相關函數CVR_Initm：函數原型intCVR_Initm(intPort);參數Port[in]：連接串口〔1~16〕或USB口(1001~1016)返回值referCVR_ERR_***功能描述連接PC與第二代居民閱讀器。CVR_Closem：函數原型intCVR_Closem(void);參數無返回值referCVR_ERR_***<Ahref=".corewise./">PDA</A>功能描述本函數用于關閉PC到閱讀器的連接。CVR_Authenticate：函數原型intCVR_Authenticate(void);參數無返回值referCVR_ERR_***功能描述本函數用于讀卡器和卡片之間的合法身份確認?？ㄕJ證循環(huán)間隔大于300ms。CVR_Read_Content：函數原型intCVR_Read_Content(intActive);參數Active[in]:1:生成文字wz.t*t、相片數據*p.wlt和相片zp.bmp(解碼)2:生成文字wz.t*t和相片數據*p.wlt4:生成wz.t*t(解碼)，相片zp.bmp(解碼)6:生成以設備模塊命名的.t*t文件(解碼)，相片.bmp文件(解碼)返回值referCVR_ERR_***功能描述本函數用于通過閱讀器從第二代居民中讀取相應信息?？ㄕJ證成功以后才可做讀卡操作，讀卡完畢假設繼續(xù)讀卡應移走二代證卡片重新放置做卡認證。CVR_Ant：函數原型intCVR_Ant(intmode);參數mode[in]:0:關閉射頻1:翻開射頻返回值referCVR_ERR_***功能描述本函數用于翻開/關閉射頻。注：CVR_Initm調用成功以后，該函數有效。獲取具體信息函數下面是一組獲取具體信息的函數：函數原型intGetPeopleName(char*strTmp,int*strLen); //得到信息intGetPeopleSe*(char*strTmp,int*strLen);//得到性別信息 intGetPeopleNation(char*strTmp,int*strLen); //得到民族信息 intGetPeopleBirthday(char*strTmp,int*strLen); //得到出生日期 intGetPeopleAddress(char*strTmp,int*strLen); //得到地址信息 intGetPeopleIDCode(char*strTmp,int*strLen); //得到卡號信息 intGetDepartment(char*strTmp,int*strLen);//得到發(fā)證機關信息intGetStartDate(char*strTmp,int*strLen);//得到有效開場日期〔簽發(fā)日期〕intGetEndDate(char*strTmp,int*strLen); //得到有效截止日期intGetManuID(int*pID);<Ahref=".corewise./">手持終端</A>//讀取設備模塊參數strTmp[out]:存放的具體信息strLen[in]:strTmp的最大長度返回值referCVR_ERR_***功能描述以上函數調用流程為：調用CVR_Read_Content函數成功后再分別調用以上函數。CVR_Read_Content函數自動在應用程序當前目錄產生BMP照片文件。GetManulID函數原型intGetManuID(int*pID);參數pID[out]:得到的設備模塊返回值referCVR_ERR_***功能描述讀取設備模塊人證比對相關函數人證比對初始化：函數原型intCVR_VerifyInit(void);參數無返回值referCVR_ERR_***功能描述人證比對〔人員照片與照片比對〕初始化函數人證比對關閉：函數原型intCVR_VerifyUninit(void);參數無返回值referCVR_ERR_***功能描述人證比對關閉函數，用來釋放空間人證比對：函數原型intCVR_PersonImgVsIdCardImg(char*personImgData,intpersonImgDataLen,char*idCardImgData,intidCardImgDataLen,float*score);參數personImgData[in]:bmp格式的人員圖像數據personImgDataLen[in]:人員圖像數據長度idCardImgData[in]:bmp格式的圖像數據idCardImgDataLen[in]:圖像數據長度score[out]:人證比對得到的分數返回值referCVR_ERR_***.bird-homes./功能描述人證比對〔人員照片與照片比對〕函數調用流程閱讀器SDK庫應用函數的調用流程如下列圖所示：開場開場初始化連接翻開射頻關閉射頻讀卡操作CVR_Read_Content關閉連接完畢卡認證讀卡至內存緩存CVR_ReadBaseMsg閱讀器SDK文件夾組成閱讀器SDK，由下述文件夾組成：·Include包含閱讀器SDK庫頭文件〔termb.h〕；·lib包含閱讀器SDK庫文件〔靜態(tài)庫：termb.lib，動態(tài)庫：termb.dll，CVRApi.dll，sdtapi.dll，WLTLib.dll〕等；·license包含文件：license.lic,base.dat·e*ample包含閱讀器SDK庫測試程序；·doc包含閱讀器相關文檔說明〔閱讀器SDK使用說明.doc〕。身份閱讀器SDK的使用SDK使用方法〔1〕靜態(tài)庫的適用方法：在VC環(huán)境下添加termb.lib附加依賴項，在調用它的應用程序里包含相應的termb.h頭文件。 〔2〕動態(tài)庫適用方法：在應用程序里用LoadLibrary("termb.dll");語句把動態(tài)庫加載進來，不用包含相應頭文件，應用程序可以直接調用該動態(tài)庫中的函數接口。SDK使用限制當SDK提供的函數接收到不正確的參數時，將返回錯誤結果。本SDK不支持多線程運行；應用程序調用SDK中函數，除需要加載termb.dll以外，運行.e*e可執(zhí)行程序時，還需將CVRApi.dll，sdtapi.dll，WLTLib.dll放在可執(zhí)行文件.e*e所在目錄；license文件夾里的license.lic，base.dat放在可執(zhí)行文件.e*e所在目錄。注：·程序運行時，如果序列號不正確，將產生serialNum.t*t文件來保存設備的序列號；·設備授權由license文件決定閱讀器SDK測試程序用VC翻開測試程序的工程文件，運行出現如下界面，點擊讀卡按鈕，調用OnOK()函數。OnOK()函數如下所示：voidCMyStaticDlg::OnOK(){intiRetUSB=0,iRet=0;intiPort;//搜索USB口for(iPort=1001;iPort<=1016;iPort++) {//調用CVR_Initm〔〕函數iRetUSB=CVR_Initm(iPort);if(iRetUSB==1) {//調用CVR_Initm()函數成功，break跳出for循環(huán)break; } }//如果iRetUSB!=1成立，USB口初始化失敗，繼續(xù)初始化串口if(iRetUSB!=1) {//搜索串口for(iPort=0;iPort<=5;iPort++) {iRet=CVR_Initm(iPort);if(iRet==1) {//串口初始化成功，break跳出for循環(huán)break; } } }//串口或USB口初始化成功后，進展卡認證和讀卡操作if((iRet==1)||(iRetUSB==1)){//while(1)for(inti=0;i<10;i++) {//CVR_Authenticate()卡認證，返回1卡認證成功if(1==CVR_Authenticate()) {//CVR_Read_Content()讀卡操作，返回1讀卡操作成功if(1==CVR_Read_Content(1)) {OnLoadddbpic()