Edit

PIBIO_SENSOR_ACCEPT_CALIBRATION_DATA_FN callback function (winbio_adapter.h)

  • Article

Called by the Windows Biometric Framework to pass calibration data from the engine adapter to the sensor adapter.

Syntax

PIBIO_SENSOR_ACCEPT_CALIBRATION_DATA_FN PibioSensorAcceptCalibrationDataFn;

HRESULT PibioSensorAcceptCalibrationDataFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PUCHAR CalibrationBuffer,
  [in]      SIZE_T CalibrationBufferSize
)
{...}

Parameters

[in, out] Pipeline

Pointer to the WINBIO_PIPELINE structure associated with the biometric unit performing the operation.

[in] CalibrationBuffer

Pointer to the buffer that contains the calibration data.

[in] CalibrationBufferSize

The size in bytes of the calibration buffer.

Return value

If the function succeeds, it returns S_OK. If the function fails, it must return one of the following HRESULT values to indicate the error.

Return code Description
E_some_error
Any error code will cause the Biometric Service to discontinue the dynamic calibration loop and abort the capture operation.

Remarks

This method is called during a dynamic calibration loop.

The memory holding the calibration buffer belongs to the Windows Biometric Framework, and the Sensor Adapter must not keep any pointers to this buffer once the SensorAdapterAcceptCalibrationData method returns.

Requirements

Requirement Value
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header winbio_adapter.h (include Winbio_adapter.h)