Structure WINBIO_PRESENCE
Contient des informations sur la présence d'une personne dont la présence est surveillée.
Syntaxe
typedef struct _WINBIO_PRESENCE {
WINBIO_BIOMETRIC_TYPE Factor;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
HRESULT Status;
WINBIO_REJECT_DETAIL RejectDetail;
WINBIO_IDENTITY Identity;
ULONGLONG TrackingId;
WINBIO_PROTECTION_TICKET Ticket;
WINBIO_PRESENCE_PROPERTIES Properties;
} WINBIO_PRESENCE, *PWINBIO_PRESENCE;
Membres
-
Facteur
-
Le facteur biométrique utilisé pour surveiller la présence de l'individu.
-
SubFactor
-
Qualificateur de sous-facteur biométrique pour le facteur biométrique utilisé pour surveiller la présence de l'individu.
-
État
-
L'état de la procédure d'identification de la personne.
-
RejectDetail
-
Informations supplémentaires sur l'échec de la reconnaissance d'un individu, y compris des commentaires expliquant comment corriger l'échec.
-
Identité
-
L'identité de la personne dont la présence est surveillée, une fois cette personne identifiée.
-
TrackingId
-
Entier généré par l’adaptateur et identifiant de manière unique l’individu. L'identifiant de suivi que l'adaptateur attribue à une personne particulière est garanti constant tant que cette personne reste dans le cadre de la caméra.
-
Ticket
-
Réservé. Mis à 0 par l'adaptateur.
-
Propriétés
-
Informations spécifiques à un facteur sur la position d'un individu.
Notes
La fonction EngineAdapterIdentifyAll crée un tableau de structures WINBIO_PRESENCE et envoie ce tableau au service biométrique. Le service biométrique utilise le réseau pour mettre à jour son modèle interne d'humains à proximité de l'ordinateur.
En fonction des résultats de cette mise à jour, le service biométrique peut générer une structure WINBIO_ASYNC_RESULT pour la fonction WinBioMonitorPresence pour tout client disposant de moniteurs de présence actifs. Le membre WINBIO_ASYNC_RESULT.Operation de la structure contient WINBIO_OPERATION_MONITOR_PRESENCE et le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType fournit des informations supplémentaires sur l'état de l'individu.
Lorsqu'un individu que l'adaptateur de moteur associe à un identifiant de suivi particulier apparaît pour la première fois dans le flux d'entrée, le service biométrique génère une structure WINBIO_ASYNC_RESULT côté client où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_ARRIVAL. Cette structure est envoyée à la fonction de rappel de votre application ou à la file d'attente de messages d'application avant toute autre structure WINBIO_ASYNC_RESULT où WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.PresenceArray inclut une structure WINBIO_PRESENCE avec la même valeur pour WINBIO_PRESENCE.TrackingId.
Les combinaisons suivantes de valeurs dans le tableau de structures WINBIO_PRESENCE que le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.PresenceArray indiquent des types spécifiques de changements dans l'état d'un individu.
Lorsqu'un individu est visible dans le cadre de la caméra, mais que le moteur tente toujours d'identifier l'individu, les membres de la structure WINBIO_PRESENCE ont les valeurs du tableau suivant.
Membre Value TrackingId Entier qui identifie l'individu auprès du moteur. État S_OK Identity.Type WINBIO_ID_TYPE_NULL Dans ce cas, le service biométrique prolonge le délai d'expiration pour l'individu et ne génère pas de structure WINBIO_ASYNC_RESULT côté client pour l'identifiant de suivi où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_RECOGNIZE.
La première fois qu'une structure WINBIO_ASYNC_RESULT comprend la structure WINBIO_PRESENCE où le membre Statut est S_OK et le membre Identity.Type est WINBIO_ID_TYPE_NULL après une ou plusieurs structures WINBIO_ASYNC_RESULT comprenait une structure WINBIO_PRESENCE avec un membre Statut de WINBIO_E_BAD_CAPTURE, le moniteur de présence génère une structure unique WINBIO_ASYNC_RESULT pour l'identifiant de suivi où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_TRACK. Cette structure WINBIO_ASYNC_RESULT où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_TRACK informe le client que le problème à l'origine de l'erreur WINBIO_E_BAD_CAPTURE a été résolu. Pour plus d’informations sur les circonstances où une structure de WINBIO_PRESENCE a un membre d’état de WINBIO_E_BAD_CAPTURE, consultez la description de la façon dont l’adaptateur de moteur fournit des commentaires à l’utilisateur pour corriger les échecs de reconnaissance plus loin dans ces remarques.
Lorsqu'un individu est visible dans le cadre de la caméra, mais que le moteur tente toujours d'identifier l'individu et souhaite fournir un retour à l'utilisateur sur la façon de corriger un échec de reconnaissance, les membres de la structure WINBIO_PRESENCE ont les valeurs dans le tableau suivant.
Membre Value TrackingId Entier qui identifie l'individu auprès du moteur. État WINBIO_E_BAD_CAPTURE Identity.Type WINBIO_ID_TYPE_NULL Properties.FacialFeatures.BoundingBox, si la valeur de Factor est WINBIO_TYPE_FACIAL_FEATURES L'emplacement du visage de l'individu dans le cadre de la caméra. Properties.Iris.BoundingBox, si la valeur de Factor est WINBIO_TYPE_IRIS L'emplacement de l'iris ou des iris de l'individu dans le cadre de la caméra. Dans ce cas, le service biométrique prolonge le délai d'expiration pour l'individu et génère une structure WINBIO_ASYNC_RESULT pour l'identifiant de suivi où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_TRACK.
Lorsqu'un individu est visible dans le cadre de la caméra et que l'adaptateur moteur détermine l'identité de l'individu, les membres de la structure WINBIO_PRESENCE ont les valeurs dans le tableau suivant.
Membre Value TrackingId Entier qui identifie l'individu auprès du moteur. État S_OK Identity.Type WINBIO_ID_TYPE_SID Identity.Value.AccountSid L’identifiant de sécurité (SID) de l’individu. Dans ce cas, le service biométrique associe l'identifiant de suivi au SID de l'individu et génère une structure WINBIO_ASYNC_RESULT côté client pour l'identifiant de suivi où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_RECOGNIZE. Le service biométrique ne génère pas de structures WINBIO_ASYNC_RESULT supplémentaires côté client pour l'identifiant de suivi, sauf si l'individu quitte le cadre de la caméra.
Lorsqu'un individu est visible dans le cadre de la caméra, mais que l'adaptateur moteur détermine avec certitude que l'individu n'est pas inscrit, les membres de la structure WINBIO_PRESENCE ont les valeurs dans le tableau suivant.
Membre Value TrackingId Entier qui identifie l'individu auprès du moteur. État WINBIO_E_UNKNOWN_ID Identity.Type WINBIO_ID_TYPE_NULL Dans ce cas, le service biométrique associe l'identifiant de suivi de l'individu à une identité UNKNOWN et génère une structure WINBIO_ASYNC_RESULT côté client pour l'identifiant de suivi où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_RECOGNIZE. Le service biométrique ne génère pas de structures WINBIO_ASYNC_RESULT supplémentaires côté client pour l'identifiant de suivi, sauf si l'individu quitte le cadre de la caméra.
Lorsqu'un individu que l'adaptateur moteur associe à un identifiant de suivi particulier quitte le cadre de la caméra et cesse d'apparaître dans les valeurs renvoyées par la fonction EngineAdapterIdentifyAll, l'identifiant de suivi finit par expirer. Lorsque l'identifiant de suivi expire, le service biométrique génère une structure WINBIO_ASYNC_RESULT côté client où le membre WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType est WINBIO_CHANGE_TYPE_DEPART. L'adaptateur de moteur peut empêcher le service biométrique de générer cette structure avec la valeur WINBIO_CHANGE_TYPE_DEPART en incluant une structure WINBIO_PRESENCE dans le tableau renvoyé par EngineAdapterIdentifyAll, où le membre WINBIO_PRESENCE.Status est S_OK et le membre WINBIO_PRESENCE.Identity.Type est WINBIO_ID_TYPE_NULL comme décrit précédemment dans ces remarques. Cette action prolonge le délai d'expiration de l'identifiant de suivi sans provoquer d'activité côté client.
Spécifications
| Condition requise | Value |
|---|---|
| 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 |
|