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

Llamado por el marco biométrico de Windows para determinar el conjunto de formatos de calibración admitidos por el adaptador del sensor.

Sintaxis

PIBIO_SENSOR_QUERY_CALIBRATION_FORMATS_FN PibioSensorQueryCalibrationFormatsFn;

HRESULT PibioSensorQueryCalibrationFormatsFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_UUID FormatArray,
  [in]      SIZE_T FormatArraySize,
  [out]     PSIZE_T FormatCount
)
{...}

Parámetros

[in, out] Pipeline

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

[out] FormatArray

Dirección de una matriz de elementos WINBIO_UUID vacíos. Se espera que el método SensorAdapterQueryCalibrationFormats rellene esta matriz con uno o varios UUID que identifican los formatos de datos de calibración conocidos para el adaptador del sensor.

[in] FormatArraySize

Valor que indica el número de ranuras disponibles en FormatArray. El método SensorAdapterQueryCalibrationFormats no debe intentar escribir más de este número de elementos en FormatArray o los resultados serán impredecibles.

[out] FormatCount

Puntero a una variable que recibe los UUID numéricos devueltos en FormatArray. El método SensorAdapterQueryCalibrationFormats debe establecer este valor antes de devolverlo.

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_NOTIMPL	– El adaptador del sensor no admite la calibración dinámica.
E_some_other_error	Cualquier otro código de error hará que Windows Biometric Framework 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 inicial de una unidad biométrica.

Cada formato de calibración admitido por el adaptador de sensor se identifica mediante un valor UUID independiente.

Este método se ejecuta en el contexto de un subproceso de servidor RPC arbitrario.

Si el adaptador del sensor no admite la calibración dinámica, debe devolver un valor de E_NOTIMPL. El marco biométrico de Windows no lo tratará como un error a menos que el adaptador del motor requiera calibración dinámica. (Para obtener más información, vea la descripción del método EngineAdapterSelectCalibrationFormat ).

Si este método devuelve un valor de S_OK, se debe establecer FormatArray y FormatCount . Se trata de un error para que este método devuelva S_OK junto con un valor cero para FormatCount. Si lo hace, Windows Biometric Framework registrará un mensaje de error WINBIO_E_INVALID_CALIBRATION_FORMAT_ARRAY y anulará la configuración de la unidad biométrica.

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)