明創IDR-100有驅系列身份證閱讀器Windows/Android開發包下載

明創IDR-100臺式居民身份證閱讀器是專為身份證識別系統開發定制的一款臺式居民身份證閱讀機具，具備中國居民身份證、港澳臺居民居住證、外國人永久居留身份證讀取等功能，廣泛應用于公安、醫療、人社、銀行、房地產、建筑行業、物流、教育、考試報名等行業實名制系統。

此開發包支持明創IDR-100整機、IDR-100U整機、IDR-M10模組等機型，僅供開發人員和測試人員使用。

Windows平臺開發包，包括BS，C/S，支持USB和串口：

點擊這里下載↓

Android平臺開發包，包括USB和串口：

點擊這里下載↓

4.3.1 SDT_StartFindIDCard 

尋找居民身份證。

int SDT_StartFindIDCard (

int iPort,

unsigned char * pucManaInfo,

int iIfOpen

);

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。居民身份證驗證安全控制模塊接口 API 使用手冊 V2.0.2.0

7

pucManaInfo

[out] 無符號字符型指針，4 個字節 0x00。該指針指向的存儲空間由調用者分

配。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。

返回值： 

0x9f 找卡成功。

0x80 找卡失敗。

4.3.2 SDT_SelectIDCard 

選卡。

int SDT_SelectIDCard (

int iPort,

unsigned char * pucManaMsg,

int iIfOpen

);

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。

pucManaMsg

[out] 無符號字符型指針，8 個字節 0x00。該指針指向的存儲空間由調用者分

配。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。

返回值： 

0x90 選卡成功。

0x81 選卡失敗。

4.3.3 SDT_ReadBaseMsg 

讀取居民身份證機讀文字信息和相片信息。

int SDT_ReadBaseMsg (

int iPort,

unsigned char * pucCHMsg, 

unsigned int * puiCHMsgLen,

unsigned char * pucPHMsg, 

unsigned int * puiPHMsgLen,

int iIfOpen

);居民身份證驗證安全控制模塊接口 API 使用手冊 V2.0.2.0

8

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。

pucCHMsg

[out] 無符號字符型指針，指向讀到的文字信息,其長度由 puiCHMsgLen 參數

輸出。該指針指向的存儲空間由調用者分配，不得小于 256 字節。

puiCHMsgLen

[out] 無符號整型數指針，指向讀到的文字信息長度，最長 256 字節。

pucPHMsg

[out] 無符號字符型指針，指向讀到的相片信息，其長度由 puiPHMsgLen 參數

輸出。該指針指向的存儲空間由調用者分配，不得小于 1024 字節。

puiPHMsgLen

[out] 無符號整型數指針，指向讀到的相片信息長度，最長 1024 字節。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。

返回值： 

0x90 讀機讀文字信息和相片信息成功。

其它 讀機讀文字信息和相片信息失敗(具體含義參見 6 函數返回碼表)。

4.3.4 SDT_ReadBaseMsgToFile 

讀取居民身份證機讀文字信息和相片信息，將讀取到的信息寫到輸入參數所指定的文件

中。

int SDT_ReadBaseMsgToFile (

int iPort,

char * pcCHMsgFileName,

unsigned int * puiCHMsgFileLen,

char * pcPHMsgFileName,

unsigned int * puiPHMsgFileLen,

int iIfOpen

);

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。

pcCHMsgFileName

[in] 字符型指針，由用戶指定的文件名，將讀取到的居民身份證機讀文字信

息寫入該文件。

puiCHMsgFileLen

[out] 無符號整型數指針，文件的長度。

pcPHMsgFileName

[in] 字符型指針，由用戶指定的文件名，將讀取到的居民身份證機讀相片信

息寫入該文件。居民身份證驗證安全控制模塊接口 API 使用手冊 V2.0.2.0

9

puiPHMsgFileLen

[out] 無符號整型數指針，文件的長度。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。

返回值： 

0x90 讀機讀文字信息和相片信息成功。

其它 讀機讀文字信息和相片信息失敗（具體含義參見 6 函數返回碼表）。

4.3.5 SDT_ReadBaseFPMsg 

讀取居民身份證機讀文字信息、相片信息和指紋信息。

注意：該接口只能用于支持讀取指紋信息的 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

);

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。

pucCHMsg

[out] 無符號字符型指針，指向讀到的機讀文字信息,其長度由 puiCHMsgLen

參數輸出。該指針指向的存儲空間由調用者分配，不得小于 256 字節。

puiCHMsgLen

[out] 無符號整型數指針，指向讀到的機讀文字信息長度，最長 256 字節。

pucPHMsg

[out] 無符號字符型指針，指向讀到的機讀相片信息,其長度由 puiPHMsgLen

參數輸出。該指針指向的存儲空間由調用者分配，不得小于 1024 字節。

puiPHMsgLen

[out] 無符號整型數指針，指向讀到的機讀相片信息長度，最長 1024 字節。

pucFPMsg

[out] 無符號字符型指針，指向讀到的指紋信息,其長度由 puiFPMsgLen 參數

輸出。該指針指向的存儲空間由調用者分配，不得小于 1024 字節。

puiFPMsgLen

[out] 無符號整型數指針，指向讀到的指紋信息長度，最長 1024 字節。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。居民身份證驗證安全控制模塊接口 API 使用手冊 V2.0.2.0

10

返回值： 

0x90 讀機讀文字信息、相片信息和指紋信息成功。如果 puiFPMsgLen 指向

的無符號整數等于 0，表明身份證中沒有指紋信息；如果 puiFPMsgLen

指向的無符號整數大于 0，表明正確地讀出了指紋信息。

0x21 錯誤的命令。可使用 SDT_ReadBaseMsg 接口讀取機讀文字和相片信

息。 

0x37 指紋信息驗證錯誤。

其它 讀取機讀文字信息、相片信息和指紋信息失敗(具體含義參見 6 函數

返回碼表)。

4.3.6 SDT_ReadBaseFPMsgToFile 

讀取居民身份證機讀文字信息、相片信息和指紋信息，將讀取到的信息寫到輸入參數所

指定的文件中。

注意：該接口只能用于支持讀取指紋信息的 SAM_A。

int SDT_ReadBaseFPMsgToFile (

int iPort,

char * pcCHMsgFileName,

unsigned int * puiCHMsgFileLen,

char * pcPHMsgFileName,

unsigned int * puiPHMsgFileLen,

char * pcFPMsgFileName,

unsigned int * puiFPMsgFileLen,

int iIfOpen

);

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。

pcCHMsgFileName

[in] 由用戶指定的文件名，將讀取到的居民身份證機讀文字信息寫入該文件。

puiCHMsgFileLen

[out] 無符號整型數指針，文件的長度。

pcPHMsgFileName

[in] 由用戶指定的文件名，將讀取到的居民身份證機讀相片信息寫入該文件。

puiPHMsgFileLen

[out] 無符號整型數指針，文件的長度。

puiFPMsgFileName

[in] 由用戶指定的文件名，將讀取到的居民身份證指紋信息寫入該文件。

puiFPMsgFileLen

[out] 無符號整型數指針，文件的長度。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。居民身份證驗證安全控制模塊接口 API 使用手冊 V2.0.2.0

11

返回值： 

0x90 讀機讀文字信息、相片信息和指紋信息成功。如果 puiFPMsgFileLen

指向的無符號整數等于 0，表明身份證中沒有指紋信息；如果

puiFPMsgFileLen 指向的無符號整數大于 0，表明正確地讀出了指紋

信息。

0x21 錯誤的命令。可使用 SDT_ReadBaseMsgToFile 接口讀取機讀文字和相

片信息。

0x37 指紋信息驗證錯誤。

其它 讀取機讀文字信息、相片信息和指紋信息失敗(具體含義參見 6 函數

返回碼表)。

4.3.7 SDT_ReadNewAppMsg 

讀取追加地址信息。

int SDT_ReadNewAppMsg (

int iPort,

unsigned char * pucAppMsg,

unsigned int * puiAppMsgLen,

int iIfOpen

);

參數說明： 

iPort

[in] 整數，表示端口號。參見 SDT_OpenPort。

pucAppMsg

[out] 無符號字符串，指向讀到的追加地址信息，其長度由 puiAppMsgLen 參

數輸出。該指針指向的存儲空間由調用者分配，不得小于 70 字節。

puiAppMsgLen

[out] 指向整數的指針，指向讀到的追加地址信息長度，最長 70 字節。

iIfOpen

[in] 整數，參見 SDT_ResetSAM。

返回值： 

0x90 讀取追加地址信息成功。

0x91 居民身份證中無追加地址信息。

其它 讀取追加地址信息失敗(具體含義參見 6 函數返回碼表)。

（*由于產品升級或其他原因，明創IDR-100有驅系列身份證閱讀器Windows/Android開發包下載產品實際參數有可能變更，以實際產品為準。本文中的所有陳述、信息和建議也不構成任何明示或暗示的擔保）