PIBIO_ENGINE_IDENTIFY_ALL_FN funzione di callback (winbio_adapter.h)

Articolo
08/27/2023

Chiamato da Windows Biometric Framework per determinare le identità di tutte le persone attualmente presenti nel fotogramma della fotocamera.

Sintassi

PIBIO_ENGINE_IDENTIFY_ALL_FN PibioEngineIdentifyAllFn;

HRESULT PibioEngineIdentifyAllFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PSIZE_T PresenceCount,
  [out]     PWINBIO_PRESENCE *PresenceArray
)
{...}

Parametri

[in, out] Pipeline

Puntatore alla struttura WINBIO_PIPELINE associata all'unità biometrica che esegue l'operazione.

[out] PresenceCount

Indirizzo di una variabile che riceve il numero di presenze rilevate dalla funzione.

[out] PresenceArray

Indirizzo di una variabile che riceve un puntatore a una matrice di elementi WINBIO_PRESENCE .

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, deve restituire uno dei valori HRESULT seguenti per indicare l'errore.

Codice restituito	Descrizione
E_some_error	Qualsiasi codice di errore causerà al servizio biometrico di registrare l'errore e ignorare il fotogramma della fotocamera.

Commenti

Il servizio biometrico chiama questo metodo dopo che invia un nuovo frame di dati all'adattatore del motore.

Dopo l'elaborazione del frame di dati, questa funzione deve restituire un elemento WINBIO_PRESENCE per ogni presenza rilevata nel frame di dati.

Nel caso in cui la funzione EngineAdapterIdentifyAll non possa trovare visi nel frame, restituisce rispettivamente un valore HRESULT di S_OK e imposta i parametri PresenceCount e PresenceArray restituiti rispettivamente su zero e NULL. In altre parole, un frame che non contiene alcuna presenza umana non è una condizione di errore.

L'unica volta che EngineAdapterIdentifyAll deve restituire un HRESULT diverso da S_OK è se non vuole che il servizio bio usi il frame per aggiornare lo stato di Monitoraggio presenza. Questo dovrebbe essere un'occorrenza rara. L'adattatore del motore è responsabile dell'allocazione della matrice di elementi WINBIO_PRESENCErestituita nel parametro PresenceArray . Deve allocare questa memoria dall'heap del processo usando la funzione HeapAlloc . Dopo aver creato la matrice, diventa la proprietà di Windows Biometric Framework. Poiché framework dealloca questa memoria dopo l'uso, l'adattatore del motore non deve tentare di deallocare la matrice o salvare un puntatore a esso. Se non si segue questa regola, il danneggiamento dell'heap e i possibili arresti anomali del servizio biometrico.

I valori dei singoli elementi WINBIO_PRESENCE in PresenceArray determinano gli eventi generati per le applicazioni client. Per informazioni dettagliate, vedere la discussione della struttura WINBIO_PRESENCE .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbio_adapter.h (includere Winbio_adapter.h)

Condividi tramite