明創(chuàng)IDR-100臺(tái)式居民身份證閱讀器是專為身份證識(shí)別系統(tǒng)開(kāi)發(fā)定制的一款臺(tái)式居民身份證閱讀機(jī)具,具備中國(guó)居民身份證、港澳臺(tái)居民居住證、外國(guó)人永久居留身份證讀取等功能,廣泛應(yīng)用于公安、醫(yī)療、人社、銀行、房地產(chǎn)、建筑行業(yè)、物流、教育、考試報(bào)名等行業(yè)實(shí)名制系統(tǒng)。
此開(kāi)發(fā)包支持明創(chuàng)IDR-100整機(jī)、IDR-100U整機(jī)、IDR-M10模組等機(jī)型,僅供開(kāi)發(fā)人員和測(cè)試人員使用。
Windows平臺(tái)開(kāi)發(fā)包,包括BS,C/S,支持USB和串口:
Android平臺(tái)開(kāi)發(fā)包,包括USB和串口:
4.3.1 SDT_StartFindIDCard
尋找居民身份證。
int SDT_StartFindIDCard (
int iPort,
unsigned char * pucManaInfo,
int iIfOpen
);
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。居民身份證驗(yàn)證安全控制模塊接口 API 使用手冊(cè) V2.0.2.0
7
pucManaInfo
[out] 無(wú)符號(hào)字符型指針,4 個(gè)字節(jié) 0x00。該指針指向的存儲(chǔ)空間由調(diào)用者分
配。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。
返回值:
0x9f 找卡成功。
0x80 找卡失敗。
4.3.2 SDT_SelectIDCard
選卡。
int SDT_SelectIDCard (
int iPort,
unsigned char * pucManaMsg,
int iIfOpen
);
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。
pucManaMsg
[out] 無(wú)符號(hào)字符型指針,8 個(gè)字節(jié) 0x00。該指針指向的存儲(chǔ)空間由調(diào)用者分
配。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。
返回值:
0x90 選卡成功。
0x81 選卡失敗。
4.3.3 SDT_ReadBaseMsg
讀取居民身份證機(jī)讀文字信息和相片信息。
int SDT_ReadBaseMsg (
int iPort,
unsigned char * pucCHMsg,
unsigned int * puiCHMsgLen,
unsigned char * pucPHMsg,
unsigned int * puiPHMsgLen,
int iIfOpen
);居民身份證驗(yàn)證安全控制模塊接口 API 使用手冊(cè) V2.0.2.0
8
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。
pucCHMsg
[out] 無(wú)符號(hào)字符型指針,指向讀到的文字信息,其長(zhǎng)度由 puiCHMsgLen 參數(shù)
輸出。該指針指向的存儲(chǔ)空間由調(diào)用者分配,不得小于 256 字節(jié)。
puiCHMsgLen
[out] 無(wú)符號(hào)整型數(shù)指針,指向讀到的文字信息長(zhǎng)度,最長(zhǎng) 256 字節(jié)。
pucPHMsg
[out] 無(wú)符號(hào)字符型指針,指向讀到的相片信息,其長(zhǎng)度由 puiPHMsgLen 參數(shù)
輸出。該指針指向的存儲(chǔ)空間由調(diào)用者分配,不得小于 1024 字節(jié)。
puiPHMsgLen
[out] 無(wú)符號(hào)整型數(shù)指針,指向讀到的相片信息長(zhǎng)度,最長(zhǎng) 1024 字節(jié)。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。
返回值:
0x90 讀機(jī)讀文字信息和相片信息成功。
其它 讀機(jī)讀文字信息和相片信息失敗(具體含義參見(jiàn) 6 函數(shù)返回碼表)。
4.3.4 SDT_ReadBaseMsgToFile
讀取居民身份證機(jī)讀文字信息和相片信息,將讀取到的信息寫到輸入?yún)?shù)所指定的文件
中。
int SDT_ReadBaseMsgToFile (
int iPort,
char * pcCHMsgFileName,
unsigned int * puiCHMsgFileLen,
char * pcPHMsgFileName,
unsigned int * puiPHMsgFileLen,
int iIfOpen
);
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。
pcCHMsgFileName
[in] 字符型指針,由用戶指定的文件名,將讀取到的居民身份證機(jī)讀文字信
息寫入該文件。
puiCHMsgFileLen
[out] 無(wú)符號(hào)整型數(shù)指針,文件的長(zhǎng)度。
pcPHMsgFileName
[in] 字符型指針,由用戶指定的文件名,將讀取到的居民身份證機(jī)讀相片信
息寫入該文件。居民身份證驗(yàn)證安全控制模塊接口 API 使用手冊(cè) V2.0.2.0
9
puiPHMsgFileLen
[out] 無(wú)符號(hào)整型數(shù)指針,文件的長(zhǎng)度。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。
返回值:
0x90 讀機(jī)讀文字信息和相片信息成功。
其它 讀機(jī)讀文字信息和相片信息失?。ň唧w含義參見(jiàn) 6 函數(shù)返回碼表)。
4.3.5 SDT_ReadBaseFPMsg
讀取居民身份證機(jī)讀文字信息、相片信息和指紋信息。
注意:該接口只能用于支持讀取指紋信息的 SAM_A。
int SDT_ReadBaseFPMsg (
int iPort,
unsigned char * pucCHMsg,
unsigned int * puiCHMsgLen,
unsigned char * pucPHMsg,
unsigned int * puiPHMsgLen,
unsigned char * pucFPMsg,
unsigned int * puiFPMsgLen,
int iIfOpen
);
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。
pucCHMsg
[out] 無(wú)符號(hào)字符型指針,指向讀到的機(jī)讀文字信息,其長(zhǎng)度由 puiCHMsgLen
參數(shù)輸出。該指針指向的存儲(chǔ)空間由調(diào)用者分配,不得小于 256 字節(jié)。
puiCHMsgLen
[out] 無(wú)符號(hào)整型數(shù)指針,指向讀到的機(jī)讀文字信息長(zhǎng)度,最長(zhǎng) 256 字節(jié)。
pucPHMsg
[out] 無(wú)符號(hào)字符型指針,指向讀到的機(jī)讀相片信息,其長(zhǎng)度由 puiPHMsgLen
參數(shù)輸出。該指針指向的存儲(chǔ)空間由調(diào)用者分配,不得小于 1024 字節(jié)。
puiPHMsgLen
[out] 無(wú)符號(hào)整型數(shù)指針,指向讀到的機(jī)讀相片信息長(zhǎng)度,最長(zhǎng) 1024 字節(jié)。
pucFPMsg
[out] 無(wú)符號(hào)字符型指針,指向讀到的指紋信息,其長(zhǎng)度由 puiFPMsgLen 參數(shù)
輸出。該指針指向的存儲(chǔ)空間由調(diào)用者分配,不得小于 1024 字節(jié)。
puiFPMsgLen
[out] 無(wú)符號(hào)整型數(shù)指針,指向讀到的指紋信息長(zhǎng)度,最長(zhǎng) 1024 字節(jié)。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。居民身份證驗(yàn)證安全控制模塊接口 API 使用手冊(cè) V2.0.2.0
10
返回值:
0x90 讀機(jī)讀文字信息、相片信息和指紋信息成功。如果 puiFPMsgLen 指向
的無(wú)符號(hào)整數(shù)等于 0,表明身份證中沒(méi)有指紋信息;如果 puiFPMsgLen
指向的無(wú)符號(hào)整數(shù)大于 0,表明正確地讀出了指紋信息。
0x21 錯(cuò)誤的命令??墒褂?SDT_ReadBaseMsg 接口讀取機(jī)讀文字和相片信
息。
0x37 指紋信息驗(yàn)證錯(cuò)誤。
其它 讀取機(jī)讀文字信息、相片信息和指紋信息失敗(具體含義參見(jiàn) 6 函數(shù)
返回碼表)。
4.3.6 SDT_ReadBaseFPMsgToFile
讀取居民身份證機(jī)讀文字信息、相片信息和指紋信息,將讀取到的信息寫到輸入?yún)?shù)所
指定的文件中。
注意:該接口只能用于支持讀取指紋信息的 SAM_A。
int SDT_ReadBaseFPMsgToFile (
int iPort,
char * pcCHMsgFileName,
unsigned int * puiCHMsgFileLen,
char * pcPHMsgFileName,
unsigned int * puiPHMsgFileLen,
char * pcFPMsgFileName,
unsigned int * puiFPMsgFileLen,
int iIfOpen
);
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。
pcCHMsgFileName
[in] 由用戶指定的文件名,將讀取到的居民身份證機(jī)讀文字信息寫入該文件。
puiCHMsgFileLen
[out] 無(wú)符號(hào)整型數(shù)指針,文件的長(zhǎng)度。
pcPHMsgFileName
[in] 由用戶指定的文件名,將讀取到的居民身份證機(jī)讀相片信息寫入該文件。
puiPHMsgFileLen
[out] 無(wú)符號(hào)整型數(shù)指針,文件的長(zhǎng)度。
puiFPMsgFileName
[in] 由用戶指定的文件名,將讀取到的居民身份證指紋信息寫入該文件。
puiFPMsgFileLen
[out] 無(wú)符號(hào)整型數(shù)指針,文件的長(zhǎng)度。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。居民身份證驗(yàn)證安全控制模塊接口 API 使用手冊(cè) V2.0.2.0
11
返回值:
0x90 讀機(jī)讀文字信息、相片信息和指紋信息成功。如果 puiFPMsgFileLen
指向的無(wú)符號(hào)整數(shù)等于 0,表明身份證中沒(méi)有指紋信息;如果
puiFPMsgFileLen 指向的無(wú)符號(hào)整數(shù)大于 0,表明正確地讀出了指紋
信息。
0x21 錯(cuò)誤的命令??墒褂?SDT_ReadBaseMsgToFile 接口讀取機(jī)讀文字和相
片信息。
0x37 指紋信息驗(yàn)證錯(cuò)誤。
其它 讀取機(jī)讀文字信息、相片信息和指紋信息失敗(具體含義參見(jiàn) 6 函數(shù)
返回碼表)。
4.3.7 SDT_ReadNewAppMsg
讀取追加地址信息。
int SDT_ReadNewAppMsg (
int iPort,
unsigned char * pucAppMsg,
unsigned int * puiAppMsgLen,
int iIfOpen
);
參數(shù)說(shuō)明:
iPort
[in] 整數(shù),表示端口號(hào)。參見(jiàn) SDT_OpenPort。
pucAppMsg
[out] 無(wú)符號(hào)字符串,指向讀到的追加地址信息,其長(zhǎng)度由 puiAppMsgLen 參
數(shù)輸出。該指針指向的存儲(chǔ)空間由調(diào)用者分配,不得小于 70 字節(jié)。
puiAppMsgLen
[out] 指向整數(shù)的指針,指向讀到的追加地址信息長(zhǎng)度,最長(zhǎng) 70 字節(jié)。
iIfOpen
[in] 整數(shù),參見(jiàn) SDT_ResetSAM。
返回值:
0x90 讀取追加地址信息成功。
0x91 居民身份證中無(wú)追加地址信息。
其它 讀取追加地址信息失敗(具體含義參見(jiàn) 6 函數(shù)返回碼表)。
(*由于產(chǎn)品升級(jí)或其他原因,明創(chuàng)IDR-100有驅(qū)系列身份證閱讀器Windows/Android開(kāi)發(fā)包下載產(chǎn)品實(shí)際參數(shù)有可能變更,以實(shí)際產(chǎn)品為準(zhǔn)。本文中的所有陳述、信息和建議也不構(gòu)成任何明示或暗示的擔(dān)保)