110,571
社区成员
发帖
与我相关
我的任务
分享
WIS_Enroll
Synopsis
int WINAPI WIS_Enroll(HANDLE hInit, unsigned char *rEnrlTemplate )
Parameter
hInit
The handle returned by WIS_InitDriver()
rEnrlTemplate
The final fingerprint code to represent the feature of a fingerprint if the enrollment is successful.
Description
Generate a final fingerprint code of 160/320/480 bytes.
Return Value
i.
QUALITY _A, QUALITY B, QUALITY C, QUALITY D: The quality of enrolled fingerprint.
ii.
QUALITY_NOT_YET : Enrollment is not completed yet.
ii.
Others < 0 : Image quality is not good enough.
Remarks
This function generates the final fingerprint code rEnrlTemplate from several input RawTemplate by collecting their common features. The purpose of enrollment is to get enough stable characteristics to represent the corresponding fingerprint.
you should call WIS_ReleaseEnroll() to release the system resource. Basically, the kernel process of enrollment works in a continuous loop as following:
1.
Use WIS_Snap() or WIS_Capture to get a good-enough fingerprint.
2.
call WIS_Enroll().
3.
If the return value is not one of the qualities defined, repeat step 1 and step 2 until the quality of the fingerprint is derived.
4.
Trials for more than 5 times and still cannot get the quality of the finger, that means the finger to enroll may not be good enough. You should change to another finger and restart the enrollment.
5.
If you want to improve the enrolled quality, you can continue executing step 1 to step 3 to get a better final fingerprint code with better quality.
6.
If you have tried to enhance the enrolled quality more than 3 times but the quality still remains in a certain quality without any improvement, it seems that the enrolled quality has been stable. Any attempt to enhancement may be in vain. You should stop the enrollment with the stable enrolled quality. If you are not satisfied with the current enrolled quality, choose another finger and restart the enrollment.
7.
call WIS_ReleaseEnroll() to free the resource.