明创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开发包下载产品实际参数有可能变更，以实际产品为准。本文中的所有陈述、信息和建议也不构成任何明示或暗示的担保）