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

Lo llama Windows Biometric Framework para obtener un conjunto de datos de calibración posteriores a la captura del adaptador del motor.

Sintaxis

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

Parámetros

[in, out] Pipeline

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

[out] DiscardAndRepeatCapture

Dirección de un valor booleano que debe establecer el método EngineAdapterQueryCalibrationData . Este valor indica lo que el servicio biométrico debe hacer con la muestra actual una vez completada la calibración.

• TRUE indica que la muestra biométrica capturada no se puede usar. El servicio biométrico descartará la muestra y recopilará una nueva.
• FALSE indica que el ejemplo es utilizable y se debe indicar al motor que realice más operaciones en él.

[out] CalibrationBuffer

Dirección de un búfer vacío donde se espera que el método escriba sus datos de calibración. La memoria que contiene este búfer pertenece al servicio biométrico y el adaptador del motor no debe mantener ningún puntero a este búfer una vez que el método EngineAdapterQueryCalibrationData devuelva.

[out] CalibrationBufferSize

Dirección de una variable en la que el método EngineAdapterQueryCalibrationData almacenará el tamaño (en bytes) de los datos de calibración que ha escrito en CalibrationBuffer. Este valor no debe superar MaxBufferSize.

Si EngineAdapterQueryCalibrationData establece este valor en cero, el contenido del Objeto CalibrationBuffer se descartará sin enviarlos al adaptador del sensor. Esta no es una condición de error; simplemente indica que el adaptador del motor no necesita actualizar la calibración del sensor en función de los datos de captura actuales.

[in] MaxBufferSize

Valor que indica el espacio máximo (en bytes) disponible para el adaptador del motor en calibrationBuffer.

Valor devuelto

Si la función se realiza correctamente, devuelve S_OK. Si se produce un error en la función, debe devolver uno de los siguientes valores HRESULT para indicar el error.

Código devuelto	Descripción
E_some_error	Cualquier código de error hará que el servicio biométrico descontinue el bucle de calibración dinámica y anule la operación de captura.

Comentarios

El método EngineAdapterQueryCalibrationData puede controlar de forma independiente el comportamiento de captura de repetición del servicio biométrico y el comportamiento de calibración estableciendo DiscardAndRepeatCapture y CalibrationBufferSize, respectivamente.

Comportamiento deseado	DiscardAndRepeatCapture	CalibrationBufferSize
Repita la captura después de la calibración.	TRUE	Distinto de cero
Repita la captura sin calibración.	TRUE	Cero
Continúe procesando la muestra después de la calibración.	FALSE	Distinto de cero
Continúe procesando la muestra sin calibración.	FALSE	Cero

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)