国腾身份证阅读器GTICR100-01_termb.dll应用开发使用手册

###国腾身份证阅读器GTICR100-01_termb.dll应用开发使用手册知识点解析####概述本手册旨在详细介绍国腾第二代居民身份证阅读器GTICR-100系列产品的termb.dll应用开发，包括函数的定义格式、调用方法及其返回值等内容。 ####使用环境与配置- **硬件需求**：本产品支持通过USB接口进行连接。如果采用USB接口，则需先安装相应的系统USB驱动程序。 - **软件需求**： - **操作系统**：适用于Windows NT 3.1及以上版本，以及Windows 98、Windows 2000等后续版本。 - **开发环境**：支持Visual C++5.0及以上版本、Visual Basic 5.0及以上版本、DELPHI 3.0及以上版本、PowerBuilder 6.0及以上版本等主流编程语言和开发工具。 - **DLL文件配置**： - termb.dll为主DLL文件，负责主要的功能实现。 - WltRS.dll为辅助DLL文件，由termb.dll调用，用户无需关注具体细节，只需确保两个DLL文件放置在同一目录下即可。 - termb.dll和WltRS.dll需与调用这些DLL的应用软件Exe文件放置在同一目录下。 - termb.dll输出的文件将被保存在调用者（即*.exe）所在的目录中。 ####函数列表与说明#####函数列表- `Int_stdcall InitComm(int Port)`：初始化串口。 - `int_stdcall CloseComm()`：关闭串口。 - `int_stdcall Authenticate()`：执行卡片认证。 - `int_stdcall Read_Content(int Active)`：读取卡片内容。 - `int_stdcall GetPeopleName(char* strTmp, int strLen)`：获取姓名信息。 - `int_stdcall GetPeopleSex(char* strTmp, int strLen)`：获取性别信息。 - `int_stdcall GetPeopleNation(char* strTmp, int strLen)`：获取民族信息。 - `int_stdcall GetPeopleBirthday(char* strTmp, int strLen)`：获取出生日期。 - `int_stdcall GetPeopleAddress(char* strTmp, int strLen)`：获取地址信息。 - `int_stdcall GetPeopleIDCode(char* strTmp, int strLen)`：获取身份证号码。 - `int_stdcall GetDepartment(char* strTmp, int strLen)`：获取发证机关信息。 - `int_stdcall GetStartDate(char* strTmp, int strLen)`：获取证件有效起始日期。 - `int_stdcall GetEndDate(char* strTmp, int strLen)`：获取证件有效截止日期。 - `int_stdcall GetReserve(char* strTmp, int strLen)`：获取保留字段信息。 - `int_stdcall SetBaseData(char* TxtFileName)`：设置基本文本信息。 - `int_stdcall SetPhotoData(char* WltFileName)`：设置照片WLT信息。 #####函数说明- **5.1初始化串口** - **原型**：`int InitComm(int Port)` - **说明**：用于初始化计算机的串口设备。 - **参数**：`Port`指定串口号，范围从1至16表示串口1至16，从1001至1016表示USB1至USB16。 - **返回值**：成功返回1，失败返回其他值。 - **示例代码**： ```c #include int main() { int li_ret = 0; int li_Port = 1; li_ret = InitComm(li_Port); return li_ret; } ``` - **5.2关闭串口** - **原型**：`int CloseComm()` - **说明**：用于关闭已打开的串口。 - **参数**：无。 - **返回值**：成功返回1，失败返回其他值。 - **示例代码**： ```c #include int main() { int li_ret = InitComm(1); //假设先初始化了串口//其他操作... li_ret = CloseComm(); return li_ret; } ``` ####函数调用流程函数调用的一般流程包括以下几个步骤： 1. **初始化串口**：通过调用`InitComm`函数初始化所需的串口。 2. **卡片认证**：使用`Authenticate`函数对身份证件进行认证。 3. **读取卡片信息**：通过调用`Read_Content`函数读取身份证信息。 4. **获取具体信息**：根据需要调用如`GetPeopleName`、`GetPeopleSex`等函数来获取具体的个人信息。 5. **关闭串口**：完成所有操作后，通过调用`CloseComm`函数关闭串口。 ####完整示例假设需要从身份证上读取姓名和性别信息，完整的调用示例如下所示： ```c #include int main() { int li_ret = 0; char name[100]; char sex[10]; //初始化串口li_ret = InitComm(1); if (li_ret != 1) { printf("初始化串口失败"); return -1; } //卡片认证li_ret = Authenticate(); if (li_ret != 1) { printf("卡片认证失败"); return -1; } //读取姓名li_ret = GetPeopleName(name, sizeof(name)); if (li_ret != 1) { printf("获取姓名失败"); return -1; } //读取性别li_ret = GetPeopleSex(sex, sizeof(sex)); if (li_ret != 1) { printf("获取性别失败"); return -1; } printf("姓名: %s ", name); printf("性别: %s ", sex); //关闭串口li_ret = CloseComm(); if (li_ret != 1) { printf("关闭串口失败"); return -1; } return 0; } ```通过上述内容，开发者可以详细了解如何利用国腾身份证阅读器GTICR100-01_termb.dll提供的函数进行身份证信息的读取和处理。这不仅涵盖了基础的函数调用流程，还提供了详细的函数说明和示例代码，帮助用户快速掌握并应用该库。