WINBIO_EXTENDED_ENROLLMENT_STATUS structure
Contains additional information about the status of an enrollment that is in progress.
Syntax
typedef struct _WINBIO_EXTENDED_ENROLLMENT_STATUS {
HRESULT TemplateStatus;
WINBIO_REJECT_DETAIL RejectDetail;
ULONG PercentComplete;
WINBIO_BIOMETRIC_TYPE Factor;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
union {
ULONG32 Null;
struct {
RECT BoundingBox;
LONG Distance;
} FacialFeatures;
struct {
ULONG GeneralSamples;
ULONG Center;
ULONG TopEdge;
ULONG BottomEdge;
ULONG LeftEdge;
ULONG RightEdge;
} Fingerprint;
struct {
RECT EyeBoundingBox_1;
RECT EyeBoundingBox_2;
POINT PupilCenter_1;
POINT PupilCenter_2;
LONG Distance;
} Iris;
struct {
ULONG32 Reserved;
} Voice;
} Specific;
} WINBIO_EXTENDED_ENROLLMENT_STATUS, *PWINBIO_EXTENDED_ENROLLMENT_STATUS;
Members
-
TemplateStatus
-
The status of sample collection for the enrollment template. The following values are possible for this member.
Value Meaning - S_OK
The enrollment is ready to be saved. - WINBIO_E_INVALID_OPERATION
No enrollment is in progress. - WINBIO_I_MORE_DATA
More samples are required to complete the template. - WINBIO_E_BAD_CAPTURE
The most recent sample is not usable. -
RejectDetail
-
The reason that the most recent sample is unusable, if the value of the TemplateStatus member is WINBIO_E_BAD_CAPTURE.
-
PercentComplete
-
The best estimate from the engine adapter for the percentage of the template that is complete, as a value from 0 to 100.
-
Factor
-
The type of biometric unit for which this structure contains information about capabilities and enrollment requirements of the engine adapter. For example, if the value of the Factor member is WINBIO_TYPE_FINGERPRINT, the WINBIO_EXTENDED_ENGINE_INFO structure applies to a fingerprint reader and contains the relevant information in the Specifc.Fingerprint structure.
-
SubFactor
-
A WINBIO_BIOMETRIC_SUBTYPE value that provides additional information about the enrollment.
-
Specific
-
Information about the status of an enrollment that is in progress for a specific biometric factor.
-
Null
-
Reserved. Must be zero.
-
FacialFeatures
-
Information about the status of an enrollment that is in progress for facial features.
-
BoundingBox
-
The position within the camera frame of the face of the individual to enroll, in pixels. The size of the camera frame determines the upper limit on the number of pixels for this position. Get the WINBIO_PROPERTY_EXTENDED_SENSOR_INFO property to determine the size of the camera frame. A client that uses the presence monitor must perform the scaling operation to map the position to the camera frame.
-
Distance
-
The distance between the actual location of the face and the ideal focal distance for the face. This value ranges from -100 to 100. 0 indicates the ideal distance, positive values indicate that the actual location of the face is too far away, and negative values indicate that the actual location is too close.
-
-
Fingerprint
-
Information about the status of an enrollment that is in progress for fingerprint patterns.
-
GeneralSamples
-
The total number of samples required to create a new fingerprint template.
-
Center
-
The number of samples for the center of the fingerprint required to create a new fingerprint template.
-
TopEdge
-
The number of samples for the top edge of the fingerprint required to create a new fingerprint template.
-
BottomEdge
-
The number of samples for the bottom edge of the fingerprint required to create a new fingerprint template.
-
LeftEdge
-
The number of samples for the left edge of the fingerprint required to create a new fingerprint template.
-
RightEdge
-
The number of samples for the right edge of the fingerprint required to create a new fingerprint template.
-
-
Iris
-
Information about the status of an enrollment that is in progress for iris patterns.
-
EyeBoundingBox_1
-
The position within the camera frame of one of the irises of the individual to enroll, in pixels. If the iris-recognition system is only monitoring one eye, this position is of the iris of that eye. If the iris-recognition system is monitoring both eyes, but only one eye is in the camera frame, this position is of the iris of the eye in the camera frame. If the iris-recognition system is monitoring both eyes, and both eyes are in the camera frame, this position is probably of the iris of the right eye of the individual.
The size of the camera frame determines the upper limit on the number of pixels for this position. Get the WINBIO_PROPERTY_EXTENDED_SENSOR_INFO property to determine the size of the camera frame. A client that uses the presence monitor must perform the scaling operation to map the position to the camera frame.
-
EyeBoundingBox_2
-
The position within the camera frame of one of the irises of the individual to enroll, in pixels. If the iris-recognition system is only monitoring one eye, or if only one eye is in the camera frame, this value is empty. If the iris-recognition system is monitoring both eyes, and both eyes are in the camera frame, this position is probably of iris of the left eye of the individual.
The size of the camera frame determines the upper limit on the number of pixels for this position. Get the WINBIO_PROPERTY_EXTENDED_SENSOR_INFO property to determine the size of the camera frame. A client that uses the presence monitor must perform the scaling operation to map the position to the camera frame.
-
PupilCenter_1
-
The position of the center of one of the pupils of the individual to enroll. If the iris-recognition system is only monitoring one eye, this position is of the center of the pupil of that eye. If the iris-recognition system is monitoring both eyes, but only one eye is in the camera frame, this position is of the center of the pupil of the eye in the camera frame. If the iris-recognition system is monitoring both eyes, and both eyes are in the camera frame, this position is probably of the center of the pupil of the right eye of the individual.
-
PupilCenter_2
-
The position of the center of one of the pupils of the individual to enroll. If the iris-recognition system is only monitoring one eye, or if only one eye is in the camera frame, this value is empty. If the iris-recognition system is monitoring both eyes, and both eyes are in the camera frame, this position is probably of the center of the pupil of the left eye of the individual.
-
Distance
-
The distance between the actual location of the iris and the ideal focal distance for the iris. This value ranges from -100 to 100. 0 indicates the ideal distance, positive values indicate that the actual location of the iris is too far away, and negative values indicate that the actual location is too close.
-
-
Voice
-
Information about the status of an enrollment that is in progress for voice patterns.
-
Reserved
-
Reserved.
-
-
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 10 [desktop apps only] |
| Minimum supported server |
Windows Server 2016 [desktop apps only] |
| Header |
|