Поделиться через

функция обратного вызова PIBIO_ENGINE_QUERY_CALIBRATION_DATA_FN (winbio_adapter.h)

  • Статья

Вызывается Платформой Биометрических данных Windows для получения набора данных калибровки после записи из адаптера подсистемы.

Синтаксис

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

Параметры

[in, out] Pipeline

Указатель на WINBIO_PIPELINE структуру, связанную с биометрической единицей, выполняющей операцию.

[out] DiscardAndRepeatCapture

Адрес логического значения, которое должно быть задано методом EngineAdapterQueryCalibrationData . Это значение указывает, что биометрическая служба должна выполнять с текущим образцом после завершения калибровки.

  • Значение TRUE указывает, что захваченный биометрический образец непригодный для использования. Биометрическая служба откатит образец и соберет новый.
  • Значение FALSE указывает, что образец пригоден для использования, и обработчику необходимо проинструктировать выполнение дальнейших операций с ним.

[out] CalibrationBuffer

Адрес пустого буфера, в который метод должен записывать данные калибровки. Память, в которой хранится этот буфер, принадлежит биометрической службе, и адаптер обработчика не должен хранить указатели на этот буфер после возврата метода EngineAdapterQueryCalibrationData .

[out] CalibrationBufferSize

Адрес переменной, в которой метод EngineAdapterQueryCalibrationData будет хранить размер (в байтах) данных калибровки, записанных в CalibrationBuffer. Это значение не должно превышать MaxBufferSize.

Если EngineAdapterQueryCalibrationData задает для этого значения нулевое значение, содержимое CalibrationBuffer будет удалено, не отправляя его в адаптер датчика. Это не является ошибкой; Он просто указывает, что адаптеру подсистемы не нужно обновлять калибровку датчика на основе текущих данных захвата.

[in] MaxBufferSize

Значение , указывающее максимальное пространство (в байтах), доступное адаптеру подсистемы в CalibrationBuffer.

Возвращаемое значение

Если функция завершается успешно, она возвращает S_OK. Если функция завершается сбоем, она должна вернуть одно из следующих значений HRESULT , чтобы указать на ошибку.

Код возврата Описание
E_some_error
Любой код ошибки приведет к тому, что биометрическая служба прекратит цикл динамической калибровки и прервет операцию записи.

Комментарии

Метод EngineAdapterQueryCalibrationData может независимо управлять поведением биометрической службы для отслеживания повторов и поведением калибровки, задав для параметра DiscardAndRepeatCapture и CalibrationBufferSize соответственно.

Требуемое поведение DiscardAndRepeatCapture CalibrationBufferSize
Повторите запись после калибровки. TRUE Ненулевая
Повторите запись без калибровки. TRUE Ноль
Продолжить обработку образца после калибровки. FALSE Ненулевая
Продолжить обработку образца без калибровки. FALSE Ноль

Требования

Требование Значение
Минимальная версия клиента Windows 10 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header winbio_adapter.h (включая Winbio_adapter.h)