estructura WINBIO_PRESENCE
Contiene información sobre la presencia de un individuo cuya presencia se está supervisando.
Sintaxis
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;
Miembros
-
Factor
-
Factor biométrico utilizado para supervisar la presencia del individuo.
-
SubFactor
-
Calificador del subfactor biométrico para el factor biométrico utilizado para supervisar la presencia de la persona.
-
Estado
-
Estado del procedimiento de identificación del individuo.
-
RejectDetail
-
Información adicional sobre el error de reconocimiento de un individuo, incluidos los comentarios que explican cómo corregir el error.
-
Identidad
-
La identidad de la persona cuya presencia se está supervisando, una vez identificada esa persona.
-
TrackingId
-
Un entero generado por el adaptador que identifica de forma única al individuo. Se garantiza que el identificador de seguimiento que el adaptador asigna a un individuo determinado sea constante siempre que esa persona permanezca en el marco de la cámara.
-
Ticket
-
Reservado. El adaptador lo establece en 0.
-
Propiedades
-
Información específica del factor sobre la posición de un individuo.
Comentarios
La función EngineAdapterIdentifyAll crea una matriz de estructuras WINBIO_PRESENCE y envía esta matriz al servicio biométrico. El servicio biométrico usa la matriz para actualizar su modelo interno de humanos cerca del equipo.
Según los resultados de esta actualización, el servicio biométrico puede generar una estructura de WINBIO_ASYNC_RESULT para la función WinBioMonitorPresencepara cualquier cliente con monitores de presencia activos. El miembro WINBIO_ASYNC_RESULT.Operation de la estructura contiene WINBIO_OPERATION_MONITOR_PRESENCE y el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType proporciona información adicional sobre el estado de la persona.
Cuando un individuo que el adaptador del motor asocia a un identificador de seguimiento determinado aparece en el flujo de entrada por primera vez, el servicio biométrico genera una estructura de WINBIO_ASYNC_RESULT del lado cliente donde el WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_ARRIVAL. Esta estructura se envía a la función de devolución de llamada de la aplicación o a la cola de mensajes de la aplicación antes de cualquier otra estructura de WINBIO_ASYNC_RESULT donde el WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.PresenceArray incluye una estructura WINBIO_PRESENCE con el mismo valor para WINBIO_PRESENCE.TrackingId.
Las siguientes combinaciones de valores de la matriz de estructuras de WINBIO_PRESENCE que el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.PresenceArray indica tipos específicos de cambios en el estado de una persona.
Cuando un individuo está visible en el marco de la cámara, pero el motor sigue intentando identificar al individuo, los miembros de la estructura de WINBIO_PRESENCE tienen los valores de la tabla siguiente.
Miembro Valor TrackingId Un entero que identifica el individuo al motor. Estado S_OK Identity.Type WINBIO_ID_TYPE_NULL En este caso, el servicio biométrico amplía el tiempo de expiración de la persona y no genera una estructura WINBIO_ASYNC_RESULTdel lado del cliente para el identificador de seguimiento donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_RECOGNIZE.
La primera vez que una estructura de WINBIO_ASYNC_RESULT incluye la estructura WINBIO_PRESENCE donde el miembro Status es S_OK y el miembro Identity.Type esWINBIO_ID_TYPE_NULL después de una o varias estructuras de WINBIO_ASYNC_RESULT incluidas una estructura de WINBIO_PRESENCE con un miembro Status de WINBIO_E_BAD_CAPTURE, el controlador de presencia genera una única estructura WINBIO_ASYNC_RESULT del identificador de seguimiento donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_TRACK. Esta estructura WINBIO_ASYNC_RESULT donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_TRACK informa al cliente de que se ha resuelto el problema que provocó el error de WINBIO_E_BAD_CAPTURE. Para obtener más información sobre las circunstancias en las que una estructura de WINBIO_PRESENCE tiene un miembro Status de WINBIO_E_BAD_CAPTURE, vea la descripción sobre cómo el adaptador de motor proporciona comentarios al usuario para corregir errores de reconocimiento más adelante en estos comentarios.
Cuando un individuo está visible en el marco de la cámara, pero el motor sigue intentando identificar al individuo y quiere proporcionar comentarios al usuario sobre cómo corregir un error de reconocimiento, los miembros de la estructura de WINBIO_PRESENCE tienen los valores de la tabla siguiente.
Miembro Valor TrackingId Un entero que identifica el individuo al motor. Estado WINBIO_E_BAD_CAPTURE Identity.Type WINBIO_ID_TYPE_NULL Properties.FacialFeatures.BoundingBox, si el valor de Factor es WINBIO_TYPE_FACIAL_FEATURES La ubicación de la cara del individuo dentro del marco de la cámara. Properties.Iris.BoundingBox, si el valor de Factor es WINBIO_TYPE_IRIS La ubicación del iris o los iris del individuo dentro del marco de la cámara. En este caso, el servicio biométrico amplía el tiempo de expiración de la persona y genera una estructura de WINBIO_ASYNC_RESULT para el identificador de seguimiento donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_TRACK.
Cuando un individuo está visible en el marco de la cámara y el adaptador del motor determina la identidad del individuo, los miembros de la estructura WINBIO_PRESENCE tienen los valores de la tabla siguiente.
Miembro Valor TrackingId Un entero que identifica el individuo al motor. Estado S_OK Identity.Type WINBIO_ID_TYPE_SID Identity.Value.AccountSid El identificador de seguridad (SID) del individuo. En este caso, el servicio biométrico asocia el identificador de seguimiento con el SID para el individuo y genera una estructura WINBIO_ASYNC_RESULT del lado cliente para el identificador de seguimiento donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_RECOGNIZE. El servicio biométrico no genera estructuras adicionales de WINBIO_ASYNC_RESULT del lado del cliente para el identificador de seguimiento a menos que el individuo salga del marco de la cámara.
Cuando un individuo está visible en el marco de la cámara, pero el adaptador del motor determina con certeza que el individuo no está inscrito, los miembros de la estructura WINBIO_PRESENCE tienen los valores de la tabla siguiente.
Miembro Valor TrackingId Un entero que identifica el individuo al motor. Estado WINBIO_E_UNKNOWN_ID Identity.Type WINBIO_ID_TYPE_NULL En este caso, el servicio biométrico asocia el identificador de seguimiento de la persona a una identidad de UNKNOWN y genera una estructura WINBIO_ASYNC_RESULT del lado del cliente para el identificador de seguimiento donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_RECOGNIZE. El servicio biométrico no genera estructuras adicionales de WINBIO_ASYNC_RESULT del lado del cliente para el identificador de seguimiento a menos que el individuo salga del marco de la cámara.
Cuando un individuo que el adaptador del motor asocia a un identificador de seguimiento determinado deja el marco de la cámara y deja de aparecer en los valores que devuelve la función EngineAdapterIdentifyAll, el identificador de seguimiento expira finalmente. Cuando expira el identificador de seguimiento, el servicio biométrico genera una estructura WINBIO_ASYNC_RESULT del lado del cliente donde el miembro WINBIO_ASYNC_RESULT.Parameters.MonitorPresence.ChangeType es WINBIO_CHANGE_TYPE_DEPART. El adaptador del motor puede impedir que el servicio biométrico genere esta estructura con el valor WINBIO_CHANGE_TYPE_DEPART mediante la inclusión de una estructura WINBIO_PRESENCE en la matriz que devuelve EngineAdapterIdentifyAll, donde el miembro WINBIO_PRESENCE.Status es S_OK y el miembro WINBIO_PRESENCE.Identity.Type es WINBIO_ID_TYPE_NULL como se ha descrito anteriormente en estos comentarios. Esta acción amplía el tiempo de expiración del identificador de seguimiento sin provocar ninguna actividad del lado del cliente.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo compatible |
Windows 10 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2016 [solo aplicaciones de escritorio] |
| Encabezado |
|