PIBIO_ENGINE_SELECT_CALIBRATION_FORMAT_FN función de devolución de llamada (winbio_adapter.h)

  • Artículo

Lo llama el marco biométrico de Windows para determinar cuál de los formatos de calibración del adaptador de sensor quiere usar el adaptador de motor.

Sintaxis

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
)
{...}

Parámetros

[in, out] Pipeline

Puntero a la estructura WINBIO_PIPELINE asociada a la unidad biométrica que realiza la operación.

[in] FormatArray

Dirección de una matriz de WINBIO_UUID elementos que identifican los formatos de datos de calibración admitidos por el adaptador del sensor. Se espera que el adaptador del motor elija uno de estos formatos para sus datos de calibración.

[in] FormatCount

Valor que indica el número de UUID en el parámetro FormatArray .

[out] SelectedFormat

Dirección de un elemento de WINBIO_UUID donde el método EngineAdapterSelectCalibrationFormat almacenará el UUID del formato de calibración seleccionado. Debe ser uno de los UUID en el parámetro FormatArray .

[out] MaxBufferSize

Dirección de una variable en la que el método EngineAdapterSelectCalibrationFormat almacenará el tamaño máximo (en bytes) de los datos de calibración que planea devolver al adaptador del sensor. El tamaño máximo de este búfer debe ser de 4096 bytes o menos.

Valor devuelto

La función devolverá uno de los siguientes valores HRESULT .

Código devuelto Descripción
S_OK
La operación se realizó correctamente. Se han establecido los valores devueltos SelectedFormat y MaxBufferSize .
E_NOTIMPL
El adaptador del motor no requiere calibración dinámica. No se trata de una condición de error. El servicio biométrico convertirá este valor en S_OK y la unidad biométrica se configurará para no usar la calibración dinámica.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT
El adaptador de motor requiere calibración dinámica, pero no admite ninguno de los formatos de calibración especificados en el parámetro FormatArray . (El adaptador del motor también debe devolver este código de error si el argumento FormatCount es cero). Este código de error hará que el servicio biométrico registre el error y anule la configuración de la unidad biométrica.
E_some_other_error
Cualquier otro código de error hará que el servicio biométrico registre el error y anule la configuración de la unidad biométrica.

Comentarios

Se llama a este método una vez durante la configuración de la unidad biométrica. Una vez seleccionado un formato de calibración, no se puede cambiar.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio_adapter.h (incluya Winbio_adapter.h)