~~NOTOC~~
[[face_api]] > [[BS2_ScanFaceEx]]

----

===== BS2_ScanFaceEx =====
[+ 2.7.1] ''Visual Face based'' Scans the face from a device and extracts template and image data.
==== Declaration ====
<code cpp>
#include "BS_API.h"

int BS2_ScanFaceEx(void* context, uint32_t deviceId, BS2FaceEx* faceEx, uint8_t enrollmentThreshold, OnReadyToScan ptrReadyToScan);
</code>

<callout type="info">
[[face_api#BS2FaceEx|See BS2FaceEx Structure]]
</callout>
==== Parameter ====
  * [In] ''//context//'' : Context
  * [In] ''//deviceId//'' : Device ID
  * [Out] ''//faceEx//'' : Face data settings pointer
  * [In] ''//enrollmentThreshold//'' : Threshold required for face enrollment
[[configuration_api#bs2faceconfig|Refer to BS2FaceConfig::enrollThreshold]]
  * [Out] ''//ptrReadyToScan//'' : Callback function called when face scanning is ready
==== Return Value ====
If successfully done, ''BS_SDK_SUCCESS'' will be returned. \\
If there is an error, the corresponding error code will be returned.
\\