WINBIO_EXTENDED_ENROLLMENT_STATUS 구조체
진행 중인 등록의 상태 대한 추가 정보를 포함합니다.
구문
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;
멤버
-
TemplateStatus
-
등록 템플릿에 대한 샘플 컬렉션의 상태. 이 멤버에 대해 다음 값을 사용할 수 있습니다.
값 의미 - S_OK
등록을 저장할 준비가 완료되었습니다. - WINBIO_E_INVALID_OPERATION
등록이 진행 중이 아닙니다. - WINBIO_I_MORE_DATA
템플릿을 완료하려면 더 많은 샘플이 필요합니다. - WINBIO_E_BAD_CAPTURE
최신 샘플은 사용할 수 없습니다. -
RejectDetail
-
TemplateStatus 멤버의 값이 WINBIO_E_BAD_CAPTURE 경우 가장 최근 샘플을 사용할 수 없는 이유입니다.
-
PercentComplete
-
0에서 100까지의 값으로 완료된 템플릿의 백분율에 대한 엔진 어댑터의 가장 좋은 추정치입니다.
-
요소
-
이 구조체에 엔진 어댑터의 기능 및 등록 요구 사항에 대한 정보가 포함된 생체 인식 단위 유형입니다. 예를 들어 Factor 멤버의 값이 WINBIO_TYPE_FINGERPRINT 경우 WINBIO_EXTENDED_ENGINE_INFO 구조체가 지문 판독기에 적용되고 Specifc.Fingerprint 구조체에 관련 정보가 포함됩니다.
-
SubFactor
-
등록에 대한 추가 정보를 제공하는 WINBIO_BIOMETRIC_SUBTYPE 값입니다.
-
특정
-
특정 생체 인식 요인에 대해 진행 중인 등록의 상태 대한 정보입니다.
-
Null
-
예약되어 있습니다. 0이어야 합니다.
-
FacialFeatures
-
얼굴 특징에 대해 진행 중인 등록의 상태 대한 정보입니다.
-
BoundingBox
-
등록할 개별 얼굴의 카메라 프레임 내 위치(픽셀)입니다. 카메라 프레임의 크기는 이 위치의 픽셀 수 상한을 결정합니다. WINBIO_PROPERTY_EXTENDED_SENSOR_INFO 속성을 가져와 카메라 프레임의 크기를 확인합니다. 프레즌스 모니터를 사용하는 클라이언트는 크기 조정 작업을 수행하여 위치를 카메라 프레임에 매핑해야 합니다.
-
거리
-
얼굴의 실제 위치와 얼굴의 이상적인 초점 거리 사이의 거리입니다. 이 값의 범위는 -100에서 100까지입니다. 0은 이상적인 거리를 나타내고 양수 값은 얼굴의 실제 위치가 너무 멀리 떨어져 있음을 나타내고 음수 값은 실제 위치가 너무 가깝다는 것을 나타냅니다.
-
-
지문
-
지문 패턴에 대해 진행 중인 등록의 상태 대한 정보입니다.
-
GeneralSamples
-
새 지문 템플릿을 만드는 데 필요한 샘플의 총 수입니다.
-
Center
-
새 지문 템플릿을 만드는 데 필요한 지문 중앙에 대한 샘플 수입니다.
-
TopEdge
-
새 지문 템플릿을 만드는 데 필요한 지문의 위쪽 가장자리에 대한 샘플 수입니다.
-
BottomEdge
-
새 지문 템플릿을 만드는 데 필요한 지문의 아래쪽 가장자리에 대한 샘플 수입니다.
-
LeftEdge
-
새 지문 템플릿을 만드는 데 필요한 지문의 왼쪽 가장자리에 대한 샘플 수입니다.
-
RightEdge
-
새 지문 템플릿을 만드는 데 필요한 지문 오른쪽 가장자리에 대한 샘플 수입니다.
-
-
아이리스
-
홍채 패턴에 대해 진행 중인 등록의 상태 대한 정보입니다.
-
EyeBoundingBox_1
-
등록할 개인의 붓꽃 중 하나의 카메라 프레임 내 위치(픽셀)입니다. 홍채 인식 시스템이 한쪽 눈만 모니터링하는 경우 이 위치는 눈의 홍채입니다. 홍채 인식 시스템이 두 눈을 모니터링하지만 한 눈만 카메라 프레임에 있는 경우 이 위치는 카메라 프레임의 눈 홍채입니다. 홍채 인식 시스템이 두 눈을 모니터링하고 두 눈이 카메라 프레임에 있는 경우, 이 위치는 아마도 개인의 오른쪽 눈의 홍채일 것입니다.
카메라 프레임의 크기는 이 위치의 픽셀 수 상한을 결정합니다. WINBIO_PROPERTY_EXTENDED_SENSOR_INFO 속성을 가져와 카메라 프레임의 크기를 확인합니다. 프레즌스 모니터를 사용하는 클라이언트는 크기 조정 작업을 수행하여 위치를 카메라 프레임에 매핑해야 합니다.
-
EyeBoundingBox_2
-
등록할 개인의 붓꽃 중 하나의 카메라 프레임 내 위치(픽셀)입니다. 홍채 인식 시스템이 한쪽 눈만 모니터링하거나 한 눈만 카메라 프레임에 있는 경우 이 값은 비어 있습니다. 홍채 인식 시스템이 두 눈을 모니터링하고 두 눈이 카메라 프레임에 있는 경우, 이 위치는 아마도 개인의 왼쪽 눈의 홍채일 것입니다.
카메라 프레임의 크기는 이 위치의 픽셀 수 상한을 결정합니다. WINBIO_PROPERTY_EXTENDED_SENSOR_INFO 속성을 가져와 카메라 프레임의 크기를 확인합니다. 프레즌스 모니터를 사용하는 클라이언트는 크기 조정 작업을 수행하여 위치를 카메라 프레임에 매핑해야 합니다.
-
PupilCenter_1
-
등록할 개별 학생 중 하나의 중심 위치입니다. 홍채 인식 시스템이 한쪽 눈만 모니터링하는 경우 이 위치는 눈동자의 중심입니다. 홍채 인식 시스템이 두 눈을 모니터링하지만 한 눈만 카메라 프레임에 있는 경우 이 위치는 카메라 프레임에서 눈동자의 가운데에 있습니다. 홍채 인식 시스템이 두 눈을 모니터링하고 두 눈이 카메라 프레임에 있는 경우, 이 위치는 아마도 개인의 오른쪽 눈동자 중심일 것입니다.
-
PupilCenter_2
-
등록할 개별 학생 중 하나의 중심 위치입니다. 홍채 인식 시스템이 한쪽 눈만 모니터링하거나 한 눈만 카메라 프레임에 있는 경우 이 값은 비어 있습니다. 홍채 인식 시스템이 두 눈을 모니터링하고 두 눈이 카메라 프레임에 있는 경우, 이 위치는 아마도 개인의 왼쪽 눈동자 중심일 것입니다.
-
거리
-
홍채의 실제 위치와 홍채에 대한 이상적인 초점 거리 사이의 거리입니다. 이 값의 범위는 -100에서 100까지입니다. 0은 이상적인 거리를 나타내고 양수 값은 홍채의 실제 위치가 너무 멀리 떨어져 있음을 나타내고 음수 값은 실제 위치가 너무 가깝다는 것을 나타냅니다.
-
-
음성
-
음성 패턴에 대해 진행 중인 등록의 상태 대한 정보입니다.
-
Reserved
-
예약되어 있습니다.
-
-
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 10 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2016 [데스크톱 앱만 해당] |
| 헤더 |
|