PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN funzione di callback (winbio_adapter.h)

Articolo
08/27/2023

Chiamato da Windows Biometric Framework per determinare quale dei formati di calibrazione dell'adattatore del sensore l'adattatore motore vuole usare.

Sintassi

PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN PibioEngineSelectCalibrationFormatFn;

HRESULT PibioEngineSelectCalibrationFormatFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatCount,
  [out]     PWINBIO_UUID SelectedFormat,
  [out]     PSIZE_T MaxBufferSize
)
{...}

Parametri

[in, out] Pipeline

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

[in] FormatArray

Indirizzo di una matrice di WINBIO_UUID elementi che identificano i formati di dati di calibrazione supportati dall'adattatore sensore. È previsto che l'adattatore del motore scelga uno di questi formati per i dati di calibrazione.

[in] FormatCount

Valore che indica il numero di UUID nel parametro FormatArray .

[out] SelectedFormat

Indirizzo di un elemento WINBIO_UUID in cui il metodo EngineAdapterSelectCalibrationFormat archivierà l'UUID del formato di calibrazione selezionato. Deve essere uno degli UUID nel parametro FormatArray .

[out] MaxBufferSize

Indirizzo di una variabile in cui il metodo EngineAdapterSelectCalibrationFormat archivierà le dimensioni massime (in byte) di tutti i dati di calibrazione che prevede di tornare all'adapter del sensore. Le dimensioni massime di questo buffer devono essere pari o inferiori a 4096 byte.

Valore restituito

La funzione restituirà uno dei valori HRESULT seguenti.

Codice restituito	Descrizione
S_OK	Operazione completata. Sono stati impostati entrambi i valori restituiti SelectedFormat e MaxBufferSize .
E_NOTIMPL	L'adattatore del motore non richiede la calibrazione dinamica. Questa non è una condizione di errore. Il servizio biometrico convertirà questo valore in S_OK e l'unità biometrica verrà configurata per non usare la calibrazione dinamica.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT	L'adattatore motore richiede la calibrazione dinamica, ma non supporta i formati di calibrazione specificati nel parametro FormatArray . L'adapter del motore deve restituire anche questo codice di errore se l'argomento FormatCount è zero. Questo codice di errore causerà la registrazione dell'errore da parte del servizio biometrico e l'interruzione della configurazione dell'unità biometrica.
E_some_other_error	Qualsiasi altro codice di errore causerà la registrazione dell'errore da parte del servizio biometrico e interromperà la configurazione dell'unità biometrica.

Commenti

Questo metodo viene chiamato una volta durante la configurazione dell'unità biometrica. Dopo aver selezionato un formato di calibrazione, non può essere modificato.

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