身份證閱讀器Firefox火狐瀏覽器控件包下載
身份證閱讀器Firefox火狐瀏覽器控件包下載
提供身份證閱讀器Firefox火狐瀏覽器下BS開發包，火狐59版本測試通過，同時支持IE瀏覽器開發，相關技術支持免費提供。
注意：本開發包只在EST-100G免驅身份證讀卡器測試通過，其他型號讀卡器沒有測試，由于測試對硬件造成的損失，我公司不承擔任何責任。
第三代身份證閱讀器，支持多種網頁瀏覽器使用，歡迎下載安裝使用
測試版本（2019年11月更新）：谷歌Chrome：78.0.3626.109 / 火狐Firefox：70.0.1 / 360安全瀏覽器：10.0.1472.0 / 360急速瀏覽器：11.* / Internet Explorer：IE11
說明：此SDK支持型號EST-100G免驅身份證讀卡器，其他品牌型號，例如華視CVR-100U，神思SS628-100U、新中新DKQ-A16D，精倫IDR210未經測試，不一定適用！
【客戶端控件部署提供兩種方式】
1、通過執行EXE安裝程序：將控件文件復制到指定目錄，注冊控件文件；
目前已經支持火狐、360極速模式、QQ極速模式等支持NPAPI的瀏覽器，以及IE瀏覽器。
支持版本：火狐4.0版本以上
谷歌：默認是禁用NPAIP插件，必須手動強制開啟才能用；
2、通過IE瀏覽器執行HTML腳本：從服務器端加載CAB包，注冊控件文件；
這種模式安裝，只支持IE瀏覽器，.CAB控件安裝是IE瀏覽器獨有的安裝模式。
3、一個是用安裝包安裝注冊，一個使用CAB包安裝注冊，
只要控件安裝注冊成功，IE就能讀卡；
根據平臺業務需要二選其一即可。
測試環境：
win7 64位操作系統，IE11測試通過，火狐50.1.0版本測試通過；
身份證閱讀器讀卡器系列接口動態鏈接庫
用戶手冊本
V 1.0.1.3
修改履歷
版本日期說明
1.0.1.02016-07-01初版
1.0.1.32016-10-12修改“SDT_StartFindIDCard”參數描述。
一 產品適用范圍
本產品是一個WINDOWS系統的動態鏈接庫。適用于WINDOWS XP及以上版本的WINDOWS操作系統。
二 產品組成
編號項目說明
1HxgcDeviceApi_J10.dllJ10系列接口動態鏈接庫
2DLL_File.dll二代證照片解碼庫
3license.dat二代證照片解碼授權許可文件
三 產品部署
本產品直接復制到PC機上即可適用，要保證產品所有組成項目都在同一個目錄下。
四 接口函數說明
4.1 接口函數列表
如下表，HxgcDeviceApi_J10.dll導出函數：
編號函數名說明
設備通訊基本函數API
1CarderOpen打開設備
2CarderClose關閉設備
3GetModuleVer獲取設備版本
4CarderBeeping讀卡器蜂鳴器控制
CPU卡API
5GetCardStatus獲取卡片狀態
6CardActiveIC卡上電復位
7CardDeActiveIC卡斷電
8CardAPDUIC卡APDU指令交互
非接觸式存儲卡API
9PiccMemActive非接觸式存儲卡激活
10PiccMemActiveHex非接觸式存儲卡激活
11PiccMemAuthSector非接觸式存儲卡認證扇區
12PiccMemAuthSectorHex非接觸式存儲卡認證扇區
13PiccMemReadBlock非接觸式存儲卡讀塊
14PiccMemReadBlockHex非接觸式存儲卡讀塊
15PiccMemWriteBlock非接觸式存儲卡寫塊
16PiccMemWriteBlockHex非接觸式存儲卡寫塊
17PiccMemReadValue非接觸式存儲卡讀值塊
18PiccMemReadValueInt非接觸式存儲卡讀值塊
19PiccMemWriteValue非接觸式存儲卡寫值塊
20PiccMemWriteValueInt非接觸式存儲卡寫值塊
21PiccMemIncValue非接觸式存儲卡加值
22PiccMemIncValueInt非接觸式存儲卡加值
23PiccMemDecValue非接觸式存儲卡減值
24PiccMemDecValueInt非接觸式存儲卡減值
25PiccMemHalt非接觸式存儲卡停止
26PiccGetTagType獲取非接觸式卡卡片類型代碼
二代證API
27SDT_GetCOMBaud查看SAM_V當前波特率
28SDT_SetCOMBaud設置SAM_V的串口的波特率
29SDT_OpenPort打開串口/USB 口
30SDT_ClosePort關閉串口/USB 口
31SDT_ResetSAM對 SAM_A 復位
32SDT_GetSAMStatus對 SAM_A 進行狀態檢測
33SDT_GetSAMID讀取SAM_A的編號，輸出為十六進制數值
34SDT_GetSAMIDToStr讀取SAM_A的編號，輸出為字符串。
35SDT_StartFindIDCard尋找居民身份證。
36SDT_SelectIDCard選卡。
37SDT_ReadBaseMsg讀取居民身份證機讀文字信息和相片信息。
38SDT_ReadBaseFPMsg讀取居民身份證機讀文字信息、相片信息和指紋信息。
39SDT_ReadNewAppMsg讀取追加地址信息。
4.2 設備通訊基本函數API接口函數說明
4.2.1 CarderOpen
● 函數功能
打開設備。
● 函數定義
int __stdcall CarderOpen( int pi_iPort, int pi_iBaud = 115200 );
● 參數說明
編號參數名說明
1pi_iPort輸入參數，
串口 : 1~16；
USB : 1001~1016；
缺省的一個USB設備端口號為1001。
2pi_iBaud輸入參數，波特率，默認為115200bps；
USB設備該參數無效。
● 返回值
0成功；
-1失敗。
4.2.2 CarderClose
關閉設備。
● 函數定義
int __stdcall CarderClose();
● 參數說明
無。
● 返回值
0成功；
-1失敗。
4.2.3 GetModuleVer
● 函數定義
int __stdcall GetModuleVer( int pi_iModule, unsigned char* po_pszModuleVer );
● 函數功能
獲取設備版本信息。
● 參數說明
編號參數名說明
1pi_iModule輸入參數，
0 接觸式IC卡模塊；
1 非接觸式卡模塊。
2po_pszModuleVer輸出參數，模塊版本信息。
● 返回值
0成功；
<0失敗。
4.2.4 CarderBeeping
● 函數定義
int __stdcall CarderBeeping( unsigned char pi_bySustainedTime,
unsigned char pi_byIntervalTime,
unsigned char pi_byTimes );
● 函數功能
讀卡器蜂鳴器控制。
● 參數說明
編號參數名說明
1pi_bySustainedTime,輸入參數，單次鳴叫持續時間, 單位100毫秒。
2pi_byIntervalTime輸入參數，鳴叫間隔時間, 單位100毫秒。
3pi_byTimes輸入參數，蜂鳴器鳴叫次數。
● 返回值
0成功；
1失敗。
4.3 CPU卡API接口函數說明
4.3.1 GetCardStatus
● 函數定義
int __stdcall GetCardStatus( unsigned char pi_bySlot );
● 函數功能
取卡片狀態。
● 參數說明
編號參數名說明
1pi_bySlot輸入參數，卡槽號，
0xFF 非接觸式卡；
0x00～0x0F 接觸式CPU卡1～卡16；
0x10～0x1F SAM卡1～卡16。
● 返回值
-1失敗；
>0 狀態號或錯誤號。
4.3.2 CardActive
● 函數定義
int __stdcall CardActive( unsigned char pi_bySlot,
unsigned char* po_pbysATR,
int* po_piATRSize );
● 函數功能
CPU卡上電復位。
● 參數說明
編號參數名說明
1pi_bySlot輸入參數，卡槽號，
0xFF 非接觸式卡；
0x00～0x0F 接觸式CPU卡1～卡16；
0x10～0x1F SAM卡1～卡16。
2po_pbysATR輸出參數，
當卡前卡槽為接觸式卡或SAM卡卡片時為 卡片ATR數據；
為非接卡時為 卡類型(1Byte = 0x0A TYPE A, = 0x0B TYPE A) + 卡片UID長度(1Byte) + 卡片UID + 卡片ATR數據。
3po_piATRSize輸出參數，ATR數據長度。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.3.3 CardDeActive
● 函數定義
int __stdcall CardDeActive( unsigned char pi_bySlot );
● 函數功能
CPU卡下電。
● 參數說明
編號參數名說明
1pi_bySlot輸入參數，卡槽號，
0xFF 非接觸式卡；
0x00～0x0F 接觸式CPU卡1～卡16；
0x10～0x1F SAM卡1～卡16。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.3.4 CardAPDU
● 函數定義
int __stdcall CardAPDU( unsigned char pi_bySlot,
unsigned char* pi_pbysSendApdu,
int pi_iSendSize,
unsigned char* po_pbysRecvApdu,
int* po_piRecvSize,
double pi_dOutTime );
● 函數功能
CPU卡APDU交互。
● 參數說明
編號參數名說明
1pi_bySlot輸入參數，卡槽號，
0xFF 非接觸式卡；
0x00～0x0F 接觸式CPU卡1～卡16；
0x10～0x1F SAM卡1～卡16。
2pi_pbysSendApdu輸入參數，APDU數據。
3pi_iSendSize輸入參數，APDU數據長度。
4po_pbysRecvApdu輸出參數，卡片響應數據。
5po_piRecvSize輸出參數，卡片響應數據長度。
6pi_dOutTime輸入參數，操作超時時間，單位：秒。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4 CPU卡API接口函數說明
4.4.1 PiccMemActive
● 函數定義
int __stdcall PiccMemActive( unsigned short pi_usDelayTimes,
unsigned char* po_pbysCardType,
unsigned char* po_pbysUID );
● 函數功能
非接觸式存儲卡激活。
● 參數說明
編號參數名說明
1pi_usDelayTimes輸入參數，等待卡進入感應區時間（單位：毫秒），
0 無需等待，無卡直接返回；
0xffff 一直等待。
2po_pbysCardType輸出參數，卡類別，1字節，
0AH A卡;
0BH B卡。
3po_pbysUID輸出參數，卡UID，4字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.2 PiccMemActiveHex
● 函數定義
int __stdcall PiccMemActiveHex( unsigned short pi_usDelayTimes,
unsigned char* po_pbysCardType,
unsigned char* po_pbysUID );
● 函數功能
非接觸式存儲卡激活。
● 參數說明
編號參數名說明
1pi_usDelayTimes輸入參數，等待卡進入感應區時間（單位：毫秒），
0 無需等待，無卡直接返回；
0xffff 一直等待。
2po_pbysCardType輸出參數，卡類別，1字節，
'A' TYPE A卡;
'B' TYPE B卡。
3po_pbysUID輸出參數，卡UID，8字節拆分后的UID，如0xAA 拆成 "AA"。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.3 PiccMemAuthSector
● 函數定義
int __stdcall PiccMemAuthSector( unsigned char pi_bySectorNo,
unsigned char pi_byKeyType,
unsigned char* pi_pbysKey );
● 函數功能
非接觸式存儲卡認證扇區。
● 參數說明
編號參數名說明
1pi_bySectorNo輸入參數，扇區號。
2pi_byKeyType,輸入參數，密鑰類型，
0x60 A密鑰；
0x61 B密鑰；
0x40 加密后的A密鑰；
0x41 加密后的B密鑰。
3pi_pbysKey輸入參數，密鑰，非加密模式時為6字節，加密模式為8字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.4 PiccMemAuthSectorHex
● 函數定義
int __stdcall PiccMemAuthSectorHex( unsigned char pi_bySectorNo,
unsigned char pi_byKeyType,
unsigned char* pi_pbysKey );
● 函數功能
非接觸式存儲卡認證扇區。
● 參數說明
編號參數名說明
1pi_bySectorNo輸入參數，扇區號。
2pi_byKeyType輸入參數，密鑰類型，
'A' A密鑰；
'B' B密鑰；
'a' 加密后的A密鑰；
'b' 加密后的B密鑰。
3pi_pbysKey輸入參數，密鑰，非加密模式時為12字節拆分后的密鑰, 加密模式時為16字節拆分后的密鑰。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.5 PiccMemReadBlock
● 函數定義
int __stdcall PiccMemReadBlock( unsigned char pi_byBlockNo,
unsigned char* po_pbysBlockData );
● 函數功能
非接觸式存儲卡讀塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2po_pbysBlockData輸出參數，數據，16字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.6 PiccMemReadBlockHex
● 函數定義
int __stdcall PiccMemReadBlockHex( unsigned char pi_byBlockNo,
unsigned char* po_pbysBlockData );
● 函數功能
非接觸式存儲卡讀塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號 從0開始。
2po_pbysBlockData輸出參數，數據，32字節拆分后的塊數據。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.7 PiccMemWriteBlock
● 函數定義
int __stdcall PiccMemWriteBlock( unsigned char pi_byBlockNo,
unsigned char* pi_pbysBlockData );
● 函數功能
非接觸式存儲卡寫塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2pi_pbysBlockData輸入參數，數據，16字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.8 PiccMemWriteBlockHex
● 函數定義
int __stdcall PiccMemWriteBlockHex( unsigned char pi_byBlockNo,
unsigned char* pi_pbysBlockData );
● 函數功能
非接觸式存儲卡寫塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2pi_pbysBlockData輸入參數，數據，32字節拆分后的塊數據。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.9 PiccMemReadValue
● 函數定義
int __stdcall PiccMemReadValue( unsigned char pi_byBlockNo,
unsigned char* po_pbysValue );
● 函數功能
非接觸式存儲卡讀值塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2po_pbysValue輸出參數，數據，4字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.10 PiccMemReadValueInt
● 函數定義
int __stdcall PiccMemReadValueInt( unsigned char pi_byBlockNo,
unsigned long* po_pulValue );
● 函數功能
非接觸式存儲卡讀值塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2po_pulValue輸出參數，值，無符號整型。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.11 PiccMemWriteValue
● 函數定義
int __stdcall PiccMemWriteValue( unsigned char pi_byBlockNo,
unsigned char* pi_pbysValue);
● 函數功能
非接觸式存儲卡寫值塊。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2pi_pbysValue輸入參數，數據，4字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.12 PiccMemWriteValueInt
● 函數定義
int __stdcall PiccMemWriteValueInt( unsigned char pi_byBlockNo,
unsigned long* pi_pulValue );
● 函數功能
非接觸式存儲卡寫值塊。
● 參數說明
編號參數名說明
1pi_byBlockNo,輸入參數，塊號。
2pi_pulValue輸入參數，值，無符號整型。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.13 PiccMemIncValue
● 函數定義
int __stdcall PiccMemIncValue( unsigned char pi_byBlockNo,
unsigned char* pi_pbysValue );
● 函數功能
非接觸式存儲卡加值。
● 參數說明
編號參數名說明
1pi_pwszFilePath輸入參數，塊號。
2pi_pwszFileName輸入參數，數據，4字節。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.14 PiccMemIncValueInt
● 函數定義
int __stdcall PiccMemIncValueInt( unsigned char pi_byBlockNo,
unsigned long* pi_pulValue );
● 函數功能
非接觸式存儲卡加值。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2pi_pulValue輸入參數，值，無符號整型。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.15 PiccMemDecValue
● 函數定義
int __stdcall PiccMemDecValue( unsigned char pi_byBlockNo,
unsigned char* pi_pbysValue );
● 函數功能
非接觸式存儲卡減值。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2pi_pulValue輸入參數，值，無符號整型。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.16 PiccMemDecValueInt
● 函數定義
int __stdcall PiccMemIncValueInt( unsigned char pi_byBlockNo,
unsigned long* pi_pulValue );
● 函數功能
非接觸式存儲卡減值。
● 參數說明
編號參數名說明
1pi_byBlockNo輸入參數，塊號。
2pi_pulValue輸入參數，值，無符號整型。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.17 PiccMemHalt
● 函數定義
int __stdcall PiccMemHalt(void);
● 函數功能
非接觸式存儲卡停止激活。
● 參數說明
無。
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.4.18 PiccGetTagType
● 函數定義
int __stdcall PiccGetTagType( unsigned char* po_pbysTagType );
● 函數功能
獲取非接觸式卡卡片類型代碼。
● 參數說明
編號參數名說明
1po_pbysTagType輸出參數，卡片類型代碼，2字節，其數值可參考如下(16進制表示)，
pucTagType[0] pucTagType[1] 卡類型
04 00 Mifare_One(S50)
02 00 Mifare_One(S70)
44 00 Mifare_UltraLight
08 00 Mifare_Pro
04 03 Mifare_ProX
44 03 Mifare_DESFire
● 返回值
0成功；
-1通訊失敗；
>0 錯誤號。
4.5 二代證API接口函數說明
4.5.1 SDT_GetCOMBaud
● 函數定義
int __stdcall SDT_GetCOMBaud( int iPort, unsigned int* puiBaudRate );
● 函數功能
查看SAM_V當前波特率(該函數只用于SAM_V采用RS232串口的情形，如果采用USB接口則不支持該API)。
● 參數說明
編號參數名說明
1iPort輸入參數,整數，表示端口號。此處端口號必須為1-16，表示串口。
2puiBaudRate輸出參數，無符號整數指針，指向普通串口當前波特率, 默認情況下為115200。
● 返回值
0x90 成功；
0x01 端口打開失敗/端口號不合法；
0x05 無法獲得該SAM_V的波特率，該SAM_V串口不可用。
4.5.2 SDT_SetCOMBaud
● 函數定義
int __stdcall SDT_SetCOMBaud( int iPort,
unsigned int uiCurrBaud,
unsigned int uiSetBaud );
● 函數功能
設置SAM_V的串口的波特率(該函數只用于SAM_V采用RS232串口的情形，如果采用USB接口則不支持該API)，設置成功后，在該SAM_V和主機注冊表中都記錄設置后的波特率，保證在SAM_V重新啟動和該套API被重新調用時采用設置后的波特率。該函數調用成功后，需要延時5毫秒，然后才能繼續與SAM_V通信。
● 參數說明
編號參數名說明
1iPort輸入參數,整數，表示端口號。此處端口號必須為1-16，表示串口。
2uiCurrBaud輸入參數，無符號整數，調用該API前已設置的業務終端與SAM_V通信的波特率(SAM_V出廠時默認,業務終端與SAM_V通信的波特率為115200).業務終端以該波特率與SAM_V通信,發出設置SAM_V新波特率的命令.。uiCurrBaud只能為下列數值之一：115200，57600，38400，19200，9600。如果uiCurrBaud數值不是這些值之一，函數返回0x21;如果已設置的波特率與uiCurrBaud不一致,則函數返回0x02,表示不能設置,調用API不成功。
3uiSetBaud輸入參數，無符號整數，將要設置的SAM_V與業務終端通信波特率。uiSetBaud只能取下列值之一：115200，57600，38400，19200，9600，如果輸入uiSetBaud參數不是這些數值之一，函數返回0x21，設置不成功,保持原來的波特率不變。
● 返回值
0x90 成功；
0x01 端口打開失敗/端口號不合法；
0x02 超時，設置不成功；
0x21 uiCurrBaud 、uiSetBaud輸入參數數值錯誤。
4.5.3 SDT_OpenPort
● 函數定義
int __stdcall SDT_OpenPort( int iPort );
● 函數功能
打開串口/USB 口。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。
串口和 USB 都只支持 16 個，分別為 1～16(十進制) 為串口，1001～1016(十進制)為 USB 口；
串口 1～16 例如： 1：串口 1(COM1) 2：串口 2(COM2)；
USB口 1001～1016 例如： 1001：USB1 1002：USB2。
● 返回值
0x90 打開端口成功；
0x01 打開端口失敗/端口號不合法。
4.5.4 SDT_ClosePort
● 函數定義
int __stdcall SDT_OpenPort( int iPort );
● 函數功能
關閉串口/USB 口。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見SDT_OpenPort。
● 返回值
0x90 打開端口成功；
0x01 打開端口失敗/端口號不合法。
4.5.5 SDT_ResetSAM
● 函數定義
int __stdcall SDT_ResetSAM( int iPort, int iIfOpen );
● 函數功能
對SAM_A復位。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見SDT_OpenPort。
2iIfOpen輸入參數，整數，
0 表示不在該函數內部打開和關閉串口，此時應確保之前調用了 SDT_OpenPort 打開端口，并且應在不需要與端口通信時，調用 SDT_ClosePort 關閉端口；
非 0 表示在 API 函數內部包含了打開端口和關閉端口函數，之前不 需要調用 SDT_OpenPort，也不用再調用 SDT_ClosePort。
● 返回值
0x90 成功；
其它 失敗(具體含義參見二代證返回錯誤定義)。
4.5.6 SDT_GetSAMStatus
● 函數定義
int __stdcall SDT_GetSAMStatus( int iPort ,int iIfOpen );
● 函數功能
對 SAM_A 進行狀態檢測。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見SDT_OpenPort。
2iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 SAM_A正常；
0x60 自檢失敗，不能接收命令；
其它 失敗(具體含義參見二代證返回錯誤定義)。
4.5.7 SDT_GetSAMID
● 函數定義
int __stdcall SDT_GetSAMID( int iPort,
unsigned char* pucSAMID,
int iIfOpen );
● 函數功能
讀取SAM_A的編號，輸出為十六進制數值。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見SDT_OpenPort。
2pucSAMID輸出參數，無符號字符串指針，SAM_A編號，16字節。該指針指向的存儲空間由調用者分配。
3iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 成功；
其它 失敗(具體含義參見二代證返回錯誤定義)。
4.5.8 SDT_GetSAMIDToStr
● 函數定義
int __stdcall SDT_GetSAMIDToStr( int iPort,
char* pcSAMID ,
int iIfOpen );
● 函數功能
讀取SAM_A的編號，輸出為字符串。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見 SDT_OpenPort。
2pcSAMID輸出參數，字符串指針，SAM_A編號。該指針指向的存儲空間由調用者分配，不得小于40 字節。
3iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 成功；
其它 失敗(具體含義參見二代證返回錯誤定義)。
4.5.9 SDT_StartFindIDCard
● 函數定義
int __stdcall SDT_StartFindIDCard( int iPort,
unsigned char* pucManaInfo ,
int iIfOpen );
● 函數功能
尋找居民身份證。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見 SDT_OpenPort。
2pucManaInfo輸出參數，無符號字符型指針，4個字節0x00。該指針指向的存儲空間由調用者分配。
3iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x9f 找卡成功；
0x80 找卡失敗。
4.5.10 SDT_SelectIDCard
● 函數定義
int __stdcall SDT_SelectIDCard( int iPort ,
unsigned char* pucManaMsg,
int iIfOpen );
● 函數功能
尋找居民身份證。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見 SDT_OpenPort。
2pucManaMsg輸出參數，無符號字符型指針。該指針指向的存儲空間由調用者分，配不小于8字節。
3iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 選卡成功；
0x81 選卡失敗。
4.5.11 SDT_ReadBaseMsg
● 函數定義
int __stdcall SDT_ReadBaseMsg( int iPort ,
unsigned char* pucCHMsg ,
unsigned int* puiCHMsgLen,
unsigned char* pucPHMsg ,
unsigned int* puiPHMsgLen,
int iIfOpen );
● 函數功能
讀取居民身份證機讀文字信息和相片信息。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見 SDT_OpenPort。
2pucCHMsg輸出參數，無符號字符型指針，指向讀到的文字信息,其長度由puiCHMsgLen參數輸出。該指針指向的存儲空間由調用者分配，不得小于256字節。
3puiCHMsgLen輸出參數，無符號整型數指針，指向讀到的文字信息長度，最長256字節。
4pucPHMsg輸出參數，無符號字符型指針，指向讀到的相片信息，其長度由puiPHMsgLen參數輸出。該指針指向的存儲空間由調用者分配，不得小于1024字節。
5puiPHMsgLen輸出參數，無符號整型數指針，指向讀到的相片信息長度，最長1024字節。
6iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 讀機讀文字信息和相片信息成功；
其它 讀機讀文字信息和相片信息失敗(具體含義參見二代證返回錯誤定義)。
4.5.12 SDT_ReadBaseFPMsg
● 函數定義
int __stdcall SDT_ReadBaseFPMsg( int iPort ,
unsigned char* pucCHMsg ,
unsigned int* puiCHMsgLen ,
unsigned char* pucPHMsg ,
unsigned int* puiPHMsgLen,
unsigned char* pucFPMsg,
unsigned int* puiFMsgLen,
int iIfOpen );
● 函數功能
讀取居民身份證機讀文字信息、相片信息和指紋信息。
注意：該接口只能用于支持讀取指紋信息的 SAM_A。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見 SDT_OpenPort。
2pucCHMsg輸出參數，無符號字符型指針，指向讀到的文字信息,其長度由puiCHMsgLen參數輸出。該指針指向的存儲空間由調用者分配，不得小于256字節。
3puiCHMsgLen輸出參數，無符號整型數指針，指向讀到的文字信息長度，最長256字節。
4pucPHMsg輸出參數，無符號字符型指針，指向讀到的相片信息，其長度由puiPHMsgLen參數輸出。該指針指向的存儲空間由調用者分配，不得小于1024字節。
5puiPHMsgLen輸出參數，無符號整型數指針，指向讀到的相片信息長度，最長1024字節。
6pucFPMsg輸出參數，無符號字符型指針，指向讀到的指紋信息,其長度由puiFPMsgLen參數輸出。該指針指向的存儲空間由調用者分配，不得小于1024字節。
7puiFMsgLen輸出參數，無符號整型數指針，指向讀到的指紋信息長度，最長1024字節。
8iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 讀機讀文字信息和相片信息成功；
其它 讀機讀文字信息和相片信息失敗(具體含義參見二代證返回錯誤定義)。
4.5.13 SDT_ReadNewAppMsg
● 函數定義
int __stdcall SDT_ReadNewAppMsg( int iPort ,
unsigned char* pucAppMsg,
unsigned int* puiAppMsgLen,
int iIfOpen );
● 函數功能
讀取居民身份證機讀文字信息、相片信息和指紋信息。
注意：該接口只能用于支持讀取指紋信息的 SAM_A。
● 參數說明
編號參數名說明
1iPort輸入參數，整數，表示端口號。參見 SDT_OpenPort。
2pucAppMsg無符號字符串，指向讀到的追加地址信息，其長度由puiAppMsgLen參數輸出。該指針指向的存儲空間由調用者分配，不得小于70字節。
3puiAppMsgLen指向整數的指針，指向讀到的追加地址信息長度，最長70字節。
8iIfOpen輸入參數，整數，參見SDT_ResetSAM。
● 返回值
0x90 讀取追加地址信息成功；
0x91 居民身份證中無追加地址信息；
其它 讀取追加地址信息失敗(具體含義參見二代證返回錯誤定義)。
產品咨詢