~~NOTOC~~
[[fingerprint_api]] > [[BS2_ScanFingerprint]]

----

===== BS2_ScanFingerprint =====
장치에서 지문을 스캔하고 템플릿을 추출합니다.
<WRAP info>
**NOTE**\\
BS2_ScanFingerprint API는 SDK Version 2.5.0에서 변경되었습니다.
상세한 정보는 [[en:release_note_250|Version 2.5.0 Release note]]를 참고하세요. 
</WRAP>
==== 함수 ====
<code cpp>
#include "BS_API.h"

int BS2_ScanFingerprint(void* context, uint32_t deviceId, BS2Fingerprint* finger, uint32_t templateIndex, uint32_t quality, uint8_t templateFormat, OnReadyToScan ptrReadyToScan);
</code>

<callout type="info">
[[fingerprint api#BS2Fingerprint|BS2Fingerprint 구조체 보기]]
</callout>
==== 파라미터 ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : 장치 식별자
  * [Out] ''//finger//'' : 템플릿 데이터를 저장할 포인터
  * [In] ''//templateIndex//'' : 템플릿 데이터 인덱스
  * [In] ''//quality//'' : 요구되는 지문 이미지 품질
  * [In] ''//templateFormat//'' : 지문 템플릿 저장 형식
  * [Out] ''//ptrReadyToScan//'' : 지문 스캔 준비가 완료되었을 때 호출되는 콜백 함수
==== 반환값 ====
성공적으로 수행될 경우 ''BS_SDK_SUCCESS''를 반환하고, 에러가 발생할 경우 상응하는 에러 코드를 반환합니다. 
\\  
==== 함께 보기 ====
[[BS2_ScanFingerprintEx]]\\ [[BS2_VerifyFingerprint]]\\ [[BS2_GetLastFingerprintImage]]\\ [[BS2_GetFingerTemplateQuality]]