Windows Biometric Framework, problem with RejectDetail of WINBIO_CAPTURE_DATA

Question

I get sample code of WBF fingerprint device in the following microsoft web pag. https://learn.microsoft.com/zh-tw/windows/win32/api/winbio_adapter/nc-winbio_adapter-pibio_sensor_finish_capture_fn?redirectedfrom=MSDN

In this page, there are definition of WINBIO_REJECT_DETAIL as following. WINBIO_FP_TOO_HIGH WINBIO_FP_TOO_LOW WINBIO_FP_TOO_LEFT WINBIO_FP_TOO_RIGHT WINBIO_FP_TOO_FAST WINBIO_FP_TOO_SLOW WINBIO_FP_POOR_QUALITY WINBIO_FP_TOO_SKEWED WINBIO_FP_TOO_SHORT WINBIO_FP_MERGE_FAILURE

My questions is all fingerprint device should support all of these reject details or just adopt to meet the read fingerprint sensor device type. Which means the developer can customize the for their own device.
For example, if fingerprint device only can reply WINBIO_FP_POOR_QUALITY, will it a problem?

Thanks for your review and any support.

Answer 1

Hello @兆宏 柯 ,

PIBIO_SENSOR_FINISH_CAPTURE_FN callback function is implemented in Sensor adapter to be called by the Windows Biometric Framework which provides APIs used by client application to implement user interface to start Biometric identification and check the result.

If you are developing sensor adapter, you supply these reject details information to the Windows Biometric Framework.

If you are developing client application, you use these reject detailed information, to show to the users why the operation fails or to guide the users to adjust finger position etc.

For example, if fingerprint device only can reply WINBIO_FP_POOR_QUALITY, will it a problem?

So, the short answer to this question is it might be a problem. Imagine such case that actual problem is the finger was too far left during scanning so it should guide the user to move the finger to right. However, the WINBIO_FP_POOR_QUALITY reject message is supplied, this somehow misleading.

Yes, you can only can reply WINBIO_FP_POOR_QUALITY but more accurate information more better.

Thank you!

---

If the answer is helpful, please click "Accept Answer" and upvote it.

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Answer 2

Hi Rita,

Yes, you are right, more accurate information can bring a better user experience to users.
For our fingerprint scanner, it is mainly used for door lock production. This kind of product usually lacks of good GUI and only has sound or LED.
During enroll\match operation, fingerprint scanner only returns one error code to HOST no matter user fingerprint is too left, too right or poor quality. The HOST will remind user to do enroll\match fingerprint again by voice\LED.
For the WBF sensor adapter function, even if only one error code is answered, it should still work normally.
Of course, we will continue to improve the algorithm to report more status to windows, thus bring a better user experience to users as you mentioned.

Thanks for your reply.