struttura WINBIO_PREedizione Standard NCE

Articolo
10/11/2023

Contiene informazioni sulla presenza di un individuo la cui presenza viene monitorata.

Sintassi

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;

Membri

Fattore: Fattore biometrico usato per monitorare la presenza dell'individuo.
SubFactoring: Qualificatore di sottofattore biometrico per il fattore biometrico usato per monitorare la presenza dell'individuo.
Stato: Stato della procedura di identificazione per l'individuo.
RejectDetail: Informazioni aggiuntive sull'errore di riconoscimento di un individuo, incluso il feedback che spiega come correggere l'errore.
Identità: Identità dell'individuo la cui presenza viene monitorata, una volta identificata l'individuo.
TrackingId: Intero generato dall'adattatore e identifica in modo univoco l'individuo. L'identificatore di rilevamento assegnato dall'adattatore a un determinato individuo è garantito che sia costante, purché tale persona rimanga nel fotogramma della fotocamera.
Biglietto: Riservato. Impostare su 0 dall'adattatore.
Proprietà: Informazioni specifiche del fattore sulla posizione di un individuo.

Osservazioni:

La funzione EngineAdapterIdentifyAll crea una matrice di strutture WINBIO_PREedizione Standard NCE e invia questa matrice al servizio biometrico. Il servizio biometrico usa la matrice per aggiornare il modello interno degli esseri umani vicino al computer.

A seconda dei risultati di questo aggiornamento, il servizio biometrico può generare una struttura WINBIO_ASYNC_RESULT per la funzione WinBioMonitorPresence per tutti i client con monitor di presenza attivi. WINBIO_ASYNC_RESULT. Il membro dell'operazione della struttura contiene WINBIO_OPERATION_MONITOR_PREedizione Standard NCE e il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType fornisce informazioni aggiuntive sullo stato del singolo utente.

Quando un individuo associato all'adattatore motore a un identificatore di rilevamento specifico viene visualizzato nel flusso di input per la prima volta, il servizio biometrico genera una struttura di WINBIO_ASYNC_RESULT lato client in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_ARRIVAL. Questa struttura viene inviata alla funzione di callback dell'applicazione o alla coda dei messaggi dell'applicazione prima di qualsiasi altra struttura WINBIO_ASYNC_RESULT in cui il WINBIO_ASYNC_RESULT. Parameters.MonitorPresence.PresenceArray include una struttura WINBIO_PREedizione Standard NCE con lo stesso valore per WINBIO_PREedizione Standard NCE. TrackingId.

Le combinazioni di valori seguenti nella matrice di strutture WINBIO_PREedizione Standard NCE WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.PresenceArray indica tipi specifici di modifiche nello stato di un individuo.

Quando un individuo è visibile nel fotogramma della fotocamera, ma il motore sta ancora tentando di identificare l'individuo, i membri della struttura WINBIO_PREedizione Standard NCE hanno i valori nella tabella seguente.

Membro Valore

TrackingId Intero che identifica l'individuo al motore.

Stato S_OK

Identity.Type WINBIO_ID_TYPE_NULL

In questo caso, il servizio biometrico estende il tempo di scadenza per l'individuo e non genera una struttura di WINBIO_ASYNC_RESULT lato client per l'identificatore di rilevamento in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_RECOGNIZE.

La prima volta che una struttura WINBIO_ASYNC_RESULT include una struttura WINBIO_PREedizione Standard NCE in cui il membro Status è S_OK e il membro Identity.Type viene WINBIO_ID_TYPE_NULL dopo una o più strutture WINBIO_ASYNC_RESULT incluso una struttura WINBIO_PREedizione Standard NCE con uno stato membro di WINBIO_E_BAD_CAPTURE, il monitoraggio presenza genera una singola struttura di WINBIO_ASYNC_RESULT per l'identificatore di rilevamento in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_TRACK. Struttura WINBIO_ASYNC_RESULT in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_TRACK informa il client che il problema che ha causato il WINBIO_E_BAD_CAPTURE errore è stato risolto. Per altre informazioni sulle circostanze in cui una struttura WINBIO_PREedizione Standard NCE ha membro Status di WINBIO_E_BAD_CAPTURE, vedere la descrizione del modo in cui l'adattatore del motore fornisce feedback all'utente per correggere gli errori di riconoscimento più avanti in queste osservazioni.

Quando un individuo è visibile nel fotogramma della fotocamera, ma il motore sta ancora cercando di identificare l'individuo e vuole fornire feedback all'utente su come correggere un errore di riconoscimento, i membri della struttura WINBIO_PREedizione Standard NCE hanno i valori nella tabella seguente.

Membro	Valore
TrackingId	Intero che identifica l'individuo al motore.
Stato	WINBIO_E_BAD_CAPTURE
Identity.Type	WINBIO_ID_TYPE_NULL
Properties.FacialFeatures.BoundingBox, se il valore di Factor è WINBIO_TYPE_FACIAL_FEATURES	Posizione del viso dell'individuo all'interno del fotogramma della fotocamera.
Properties.Iris.BoundingBox, se il valore di Factor è WINBIO_TYPE_IRIS	Posizione dell'iride o dell'iride dell'individuo all'interno del fotogramma della fotocamera.

In questo caso, il servizio biometrico estende il tempo di scadenza per l'individuo e genera una struttura di WINBIO_ASYNC_RESULT per l'identificatore di rilevamento in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_TRACK.

Quando un individuo è visibile nel fotogramma della fotocamera e l'adattatore motore determina l'identità del singolo utente, i membri della struttura WINBIO_PREedizione Standard NCE hanno i valori nella tabella seguente.

Membro	Valore
TrackingId	Intero che identifica l'individuo al motore.
Stato	S_OK
Identity.Type	WINBIO_ID_TYPE_SID
Identity.Value.AccountSid	Identificatore di sicurezza (SID) dell'utente.

In questo caso, il servizio biometrico associa l'identificatore di rilevamento al SID per l'individuo e genera una struttura di WINBIO_ASYNC_RESULT lato client per l'identificatore di rilevamento in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_RECOGNIZE. Il servizio biometrico non genera ulteriori strutture di WINBIO_ASYNC_RESULT lato client per l'identificatore di rilevamento, a meno che il singolo non lasci il fotogramma della fotocamera.

Quando un individuo è visibile nel fotogramma della fotocamera, ma l'adattatore motore determina per certo che l'utente non è registrato, i membri della struttura WINBIO_PREedizione Standard NCE hanno i valori nella tabella seguente.

Membro Valore

TrackingId Intero che identifica l'individuo al motore.

Stato WINBIO_E_UNKNOWN_ID

Identity.Type WINBIO_ID_TYPE_NULL

In questo caso, il servizio biometrico associa l'identificatore di rilevamento dell'individuo a un'identità UNKNOWN e genera una struttura di WINBIO_ASYNC_RESULT lato client per l'identificatore di rilevamento in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_RECOGNIZE. Il servizio biometrico non genera ulteriori strutture di WINBIO_ASYNC_RESULT lato client per l'identificatore di rilevamento, a meno che il singolo non lasci il fotogramma della fotocamera.

Quando un individuo associato all'adattatore motore a un determinato identificatore di rilevamento lascia il fotogramma della fotocamera e smette di apparire nei valori restituiti dalla funzione EngineAdapterIdentifyAll , l'identificatore di rilevamento alla fine scade. Quando l'identificatore di rilevamento scade, il servizio biometrico genera una struttura di WINBIO_ASYNC_RESULT lato client in cui il WINBIO_ASYNC_RESULT. Il membro Parameters.MonitorPresence.ChangeType è WINBIO_CHANGE_TYPE_DEPART. L'adattatore del motore può impedire al servizio biometrico di generare questa struttura con il valore WINBIO_CHANGE_TYPE_DEPART includendo una struttura WINBIO_PREedizione Standard NCE nella matrice restituita da EngineAdapterIdentifyAll, dove la WINBIO_PREedizione Standard NCE. Il membro status è S_OK e il WINBIO_PREedizione Standard NCE. Il membro Identity.Type è WINBIO_ID_TYPE_NULL come descritto in precedenza in queste osservazioni. Questa azione estende il tempo di scadenza per l'identificatore di rilevamento senza causare alcuna attività sul lato client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Intestazione	Winbio_types.h (includere Winbio.h per applicazioni client o Winbio_adapters.h per gli adapter)

Vedi anche

WINBIO_ASYNC_RESULT
WinBioMonitorPresence
EngineAdapterIdentifyAll

Condividi tramite