PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN funzione di callback (winbio_adapter.h)

Articolo
03/03/2024

Chiamato da Windows Biometric Framework per ottenere un set di dati di calibrazione post-acquisizione dalla scheda del motore.

Sintassi

PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN PibioEngineQueryCalibrationDataFn;

HRESULT PibioEngineQueryCalibrationDataFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PBOOLEAN DiscardAndRepeatCapture,
  [out]     PUCHAR CalibrationBuffer,
  [out]     PSIZE_T CalibrationBufferSize,
  [in]      SIZE_T MaxBufferSize
)
{...}

Parametri

[in, out] Pipeline

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

[out] DiscardAndRepeatCapture

Indirizzo di un valore booleano che deve essere impostato dal metodo EngineAdapterQueryCalibrationData . Questo valore indica le operazioni che il servizio biometrico deve eseguire con il campione corrente al termine della calibrazione.

TRUE indica che il campione biometrico acquisito non è utilizzabile. Il servizio biometrico eliminerà il campione e ne raccoglierà uno nuovo.
FALSE indica che l'esempio è utilizzabile e il motore deve essere richiesto di eseguire ulteriori operazioni su di esso.

[out] CalibrationBuffer

Indirizzo di un buffer vuoto in cui si prevede che il metodo scriva i dati di calibrazione. La memoria che contiene questo buffer appartiene al servizio biometrico e l'adapter del motore non deve mantenere alcun puntatore a questo buffer dopo che il metodo EngineAdapterQueryCalibrationData restituisce.

[out] CalibrationBufferSize

Indirizzo di una variabile in cui il metodo EngineAdapterQueryCalibrationData archivierà le dimensioni (in byte) dei dati di calibrazione scritti in CalibrationBuffer. Questo valore non deve superare MaxBufferSize.

Se EngineAdapterQueryCalibrationData imposta questo valore su zero, il contenuto di CalibrationBuffer verrà rimosso senza inviarlo all'adapter del sensore. Questa non è una condizione di errore; indica semplicemente che l'adattatore motore non deve aggiornare la calibrazione del sensore in base ai dati di acquisizione correnti.

[in] MaxBufferSize

Valore che indica lo spazio massimo ,in byte, disponibile per l'adattatore motore in CalibrazioneBuffer.

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à l'interruzione del ciclo di calibrazione dinamica da parte del servizio biometrico e l'interruzione dell'operazione di acquisizione.

Commenti

Il metodo EngineAdapterQueryCalibrationData può controllare in modo indipendente il comportamento di ripetizione dell'acquisizione del servizio biometrico e il comportamento di calibrazione impostando rispettivamente DiscardAndRepeatCapture e CalibrationBufferSize.

Comportamento desiderato	DiscardAndRepeatCapture	CalibrazioneBufferSize
Ripetere l'acquisizione dopo la calibrazione.	TRUE	Diverso da zero
Ripetere l'acquisizione senza calibrazione.	TRUE	Zero
Continuare a elaborare il campione dopo la calibrazione.	FALSE	Diverso da zero
Continuare a elaborare il campione senza calibrazione.	FALSE	Zero

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