Partager via


WINBIO_EXTENDED_ENROLLMENT_STATUS structure

Contient des informations supplémentaires sur la status d’une inscription en cours.

Syntaxe

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;

Membres

TemplateStatus

Status d’exemples de collection pour le modèle d’inscription. Les valeurs suivantes sont possibles pour ce membre.

Valeur Signification
S_OK
L’inscription est prête à être enregistrée.
WINBIO_E_INVALID_OPERATION
Aucune inscription n’est en cours.
WINBIO_I_MORE_DATA
D’autres exemples sont nécessaires pour compléter le modèle.
WINBIO_E_BAD_CAPTURE
L’exemple le plus récent n’est pas utilisable.

RejectDetail

Raison pour laquelle l’échantillon le plus récent est inutilisable, si la valeur du membre TemplateStatus est WINBIO_E_BAD_CAPTURE.

PercentComplete

Meilleure estimation de l’adaptateur moteur pour le pourcentage du modèle terminé, sous la forme d’une valeur comprise entre 0 et 100.

Factor

Type d’unité biométrique pour laquelle cette structure contient des informations sur les fonctionnalités et les exigences d’inscription de l’adaptateur moteur. Par exemple, si la valeur du membre Factor est WINBIO_TYPE_FINGERPRINT, la structure WINBIO_EXTENDED_ENGINE_INFO s’applique à un lecteur d’empreintes digitales et contient les informations pertinentes dans la structure Specifc.Fingerprint .

Sous-facteur

Valeur WINBIO_BIOMETRIC_SUBTYPE qui fournit des informations supplémentaires sur l’inscription.

Spécifique

Informations sur la status d’une inscription en cours pour un facteur biométrique spécifique.

Null

Réservé. Doit être zéro.

FacialFeatures

Informations sur la status d’une inscription en cours pour les caractéristiques faciales.

Boundingbox

Position dans le cadre de la caméra du visage de la personne à inscrire, en pixels. La taille du cadre de l’appareil photo détermine la limite supérieure du nombre de pixels pour cette position. Obtenez la propriété WINBIO_PROPERTY_EXTENDED_SENSOR_INFO pour déterminer la taille du cadre de l’appareil photo. Un client qui utilise le moniteur de présence doit effectuer l’opération de mise à l’échelle pour mapper la position à l’image de la caméra.

Distance

Distance entre l’emplacement réel du visage et la distance focale idéale pour le visage. Cette valeur est comprise entre -100 et 100. 0 indique la distance idéale, les valeurs positives indiquent que l’emplacement réel du visage est trop éloigné, et les valeurs négatives indiquent que l’emplacement réel est trop proche.

Empreinte digitale

Informations sur la status d’une inscription en cours pour les modèles d’empreinte digitale.

GénéralÉchantillons

Nombre total d’échantillons requis pour créer un modèle d’empreinte digitale.

Center

Nombre d’échantillons pour le centre de l’empreinte digitale requis pour créer un modèle d’empreinte digitale.

TopEdge

Nombre d’échantillons pour le bord supérieur de l’empreinte digitale requis pour créer un modèle d’empreinte digitale.

BottomEdge

Nombre d’échantillons pour le bord inférieur de l’empreinte digitale requis pour créer un modèle d’empreinte digitale.

LeftEdge

Nombre d’échantillons pour le bord gauche de l’empreinte digitale requis pour créer un modèle d’empreinte digitale.

RightEdge

Nombre d’échantillons pour le bord droit de l’empreinte digitale requis pour créer un modèle d’empreinte digitale.

Iris

Informations sur la status d’une inscription en cours pour les modèles iris.

EyeBoundingBox_1

Position dans le cadre de l’appareil photo de l’un des iris de la personne à inscrire, en pixels. Si le système de reconnaissance de l’iris ne surveille qu’un œil, cette position est de l’iris de cet œil. Si le système de reconnaissance d’iris surveille les deux yeux, mais qu’un seul œil est dans le cadre de la caméra, cette position est de l’iris de l’œil dans le cadre de la caméra. Si le système de reconnaissance de l’iris surveille les deux yeux, et les deux yeux sont dans le cadre de la caméra, cette position est probablement de l’iris de l’œil droit de l’individu.

La taille du cadre de l’appareil photo détermine la limite supérieure du nombre de pixels pour cette position. Obtenez la propriété WINBIO_PROPERTY_EXTENDED_SENSOR_INFO pour déterminer la taille du cadre de l’appareil photo. Un client qui utilise le moniteur de présence doit effectuer l’opération de mise à l’échelle pour mapper la position à l’image de la caméra.

EyeBoundingBox_2

Position dans le cadre de l’appareil photo de l’un des iris de la personne à inscrire, en pixels. Si le système de reconnaissance d’iris ne surveille qu’un seul œil, ou si un seul œil se trouve dans le cadre de la caméra, cette valeur est vide. Si le système de reconnaissance d’iris surveille les deux yeux, et les deux yeux sont dans le cadre de la caméra, cette position est probablement de l’iris de l’œil gauche de l’individu.

La taille du cadre de l’appareil photo détermine la limite supérieure du nombre de pixels pour cette position. Obtenez la propriété WINBIO_PROPERTY_EXTENDED_SENSOR_INFO pour déterminer la taille du cadre de l’appareil photo. Un client qui utilise le moniteur de présence doit effectuer l’opération de mise à l’échelle pour mapper la position à l’image de la caméra.

PupilCenter_1

Position du centre de l’un des élèves de l’individu à inscrire. Si le système de reconnaissance de l’iris ne surveille qu’un seul œil, cette position est du centre de la pupille de cet œil. Si le système de reconnaissance d’iris surveille les deux yeux, mais qu’un seul œil est dans le cadre de la caméra, cette position est au centre de la pupille de l’œil dans le cadre de la caméra. Si le système de reconnaissance de l’iris surveille les deux yeux, et les deux yeux sont dans le cadre de la caméra, cette position est probablement du centre de la pupille de l’œil droit de l’individu.

PupilCenter_2

Position du centre de l’un des élèves de l’individu à inscrire. Si le système de reconnaissance d’iris ne surveille qu’un seul œil, ou si un seul œil se trouve dans le cadre de la caméra, cette valeur est vide. Si le système de reconnaissance d’iris surveille les deux yeux, et les deux yeux sont dans le cadre de la caméra, cette position est probablement du centre de la pupille de l’œil gauche de l’individu.

Distance

Distance entre l’emplacement réel de l’iris et la distance focale idéale pour l’iris. Cette valeur est comprise entre -100 et 100. 0 indique la distance idéale, les valeurs positives indiquent que l’emplacement réel de l’iris est trop éloigné, et les valeurs négatives indiquent que l’emplacement réel est trop proche.

Voice

Informations sur la status d’une inscription en cours pour les modèles de voix.

Reserved

Réservé.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 10 [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2016 [applications de bureau uniquement]
En-tête
Winbio_types.h (inclure Winbio.h pour les applications clientes ou Winbio_adapters.h pour les adaptateurs)