身份證閱讀器SDK使用說明

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