WINBIO_EXTENDED_ENROLLMENT_STATUS结构

项目
06/13/2023

包含有关正在进行的注册状态的其他信息。

语法

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

保留。必须为零。

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

要注册的单个虹膜之一的相机帧中的位置（以像素为单位）。如果虹膜识别系统仅监视一只眼睛，或者相机帧中只有一只眼睛，则此值为空。如果虹膜识别系统正在监视双眼，并且两只眼睛都在相机帧中，则此位置可能是个人左眼的虹膜。

PupilCenter_1

要注册的个人学生之一的中心位置。如果虹膜识别系统只监视一只眼睛，则此位置是该眼睛的孔的中心。如果虹膜识别系统正在监视双眼，但相机帧中只有一只眼睛，则此位置位于相机帧中眼睛的孔中心。如果虹膜识别系统正在监视双眼，并且两只眼睛都在相机帧中，则此位置可能是个人右眼的孔的中心。

PupilCenter_2

要注册的个人学生之一的中心位置。如果虹膜识别系统仅监视一只眼睛，或者相机帧中只有一只眼睛，则此值为空。如果虹膜识别系统正在监视双眼，并且两只眼睛都在相机帧中，则此位置可能是个人左眼的孔的中心。

距离

虹膜的实际位置与鸢尾花的理想焦点距离之间的距离。此值的范围为 -100 到 100。 0 表示理想距离，正值表示鸢尾花的实际位置太远，负值表示实际位置太近。

语音

有关语音模式正在进行的注册状态的信息。

Reserved: 保留。

要求

要求	值
最低受支持的客户端	Windows 10 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
标头	Winbio_types.h (包括用于客户端应用程序的 Winbio.h 或用于适配器) 的 Winbio_adapters.h

通过

WINBIO_EXTENDED_ENROLLMENT_STATUS结构

语法

成员

要求

反馈

其他资源