<붙임1> 본 규격 Ⅱ.1.라.항“연동성”과 관련된 API 세부 명세

○ 향후 단말기 표준규격의 변경 없이 본 API 세부 명세사항의 변경이 필요한 경우 단말기 표준규격과 별도로 API 세부 명세만 수정하여 공지할 수 있으며,

이 경우 행정자치부가 단말기 제작자 또는 공급자에게 API와 관련한 연계시험을 요구하면, 그에 응하여 적합성을 만족시켜야 한다.

1. 단말기 API 표준

번호	함수명	반환값	설명
1	int Ident_Open(HWND hWnd)	0 : 성공 -1 : 실패	신분증스캐너와 연결
2	int Fing_Open(HWND hWnd)	0 : 성공 -1 : 실패	지문스캐너와 연결
3	int Ident_Close()	0 : 성공 -1 : 실패	신분증스캐너 연결해제
4	int Fing_Close()	0 : 성공 -1 : 실패	지문스캐너 연결해제
3	int Ident_FullScan(HBITMAP* hBmp, int wTime);	0 : 성공 -1 : 실패	신분증 FULL 이미지 스캔 wTime : 대기시간(단위:m/s)
4	int Ident_Scan( (BYTE*)pFace, (BYTE*)pFngr, (BYTE*)pDate, (BYTE*)pName, (BYTE*)pIDNo, int wTime);	0 : 성공 -1 : 실패	신분증 이미지 스캔 pFace : 사진 이미지(RAW) pFngr : 지문 이미지(RAW) pDate : 발급일자 이미지(RAW) pName : 성명 이미지(RAW) pIDNo : 주민등록번호 이미지 (RAW) wTime : 대기시간(단위:m/s)
5	LPCTSTR STND_GetFirmVer()	펌웨어 버전정보	단말기 펌웨어 버전 조회

* 라이브러리 파일명 : “NIDCardVerify.DLL”

2. 에러코드 테이블

번호	코드	에러명	설 명
1	-1	실패	함수 호출을 실패한 경우
2	-2	드라이버 로드실패	단말기 드라이버가 로드 되지 않은 경우
3	-3	장치 없음	단말기를 인식하지 못하는 경우
4	-4	카드 없음	단말기에 카드가 없는 경우
5	-5	데이터 전송 에러	이미지 데이터 전송을 실패한 경우
6	-6	슬립발생	슬립 발생으로 이미지가 늘어진 경우
7	-7	잼 에러	단말기 카드 걸림 또는 잼 발생 경우
8	-8	카드이물질 스캔에러	카드 이물질로 스캔을 하지 못하는 경우
9	-9	카드사이즈 에러	규정된 카드 사이즈가 아닌 경우
10	-10	커버 열림 에러	단말기 커버가 열린 경우
11	-11	함수 중복호출 에러	함수 호출 후 기능 수행 시 같은 기능의 함수를 호출한 경우
12	-12	Time Out	함수 호출 시 지정된 대기시간을 초과한 경우
13	-13	지문 이미지 불량	지문 이미지가 좋지 않을 경우
14	-14	지문 core 에러	지문 이미지의 core가 없는 경우
15	-15	지문 core 치우침	지문 이미지의 core가 한쪽으로 치우친 경우

3. 에러코드 적용예

- 롤러 까지 카드 투입 후 카드를 잡고 있는 등의 이유로 카드 이송이 되지 않아
스캔 작업을 정상적으로 시작할 수 없을 때 (에러코드 -7)

- 스캔 작업이 시작된 이후 너무 긴 카드 등의 이유로 스캔 작업이 종료 되지 않을 때(에러코드 -9)

- 롤러에 카드를 물리지 않고 카드 투입부에만 카드를 살짝 투입했을 때 스캔 명령 수수 후 3초 이내에 카드가 삽입되지 않는 경우 (에러코드 -4)

- 내부에 이미 카드 등의 이물질로 스캔이 불가능할 때 (에러코드 -8)

- 카드와 롤러 사이에 슬립이 발생해 이미지가 늘어지는 경우 (에러코드 -6)

- 지정되지 않은 명령 (에러코드 -1)

- 규정되지 않는 방식의 통신 패킷이 도착했을 때 (에러코드 -1)

- 호스트에서 규정된 시간(5초) 안에 응답 패킷을 가져가지 않을 때 (에러코드 -12)

- 드라이버 로드 에러 (에러코드 -2)

- 장치 없음 에러 (에러코드 -3)

- 장치 OFF (에러코드 -3)

- 카드 없음 에러 (에러코드 -4)

- 설정 시간동안 카드가 삽입되지 않은 경우 (에러코드 -12)

- 이미지 데이터 전송 에러(API 설정과 무관. 드라이버 내부에서 설정하는 값을 초과한 경우) (에러코드 -5)

- 잼 에러 (에러코드 -7)

- 커버 열림 에러 (에러코드 -10 )

- 스캔 진행중에 다시 스캔 등의 명령을 주었을 경우 (에러코드 -11)

4. 이미지 사이즈

#define ID_WIDTH	900

#define ID_HEIGHT	172

#define DATE_WIDTH	716

#define DATE_HEIGHT	130

#define NAME_WIDTH	900

#define NAME_HEIGHT	170

#define ID_IMAGE_SIZE	154800	// 900 * 172

#define NAME_IMAGE_SIZE	153000	// 900 * 170

#define DATE_IMAGE_SIZE	93080	// 716 * 130

#define FACE_IMAGE_SIZE	279180	// 282*330*3

#define FPTR_IMAGE_SIZE	305760	// 588 * 520

#define REAL_IMAGE_SIZE	89600	// 280, 320