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

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

  • Статья

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

Синтаксис

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

Параметры

[in, out] Pipeline

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

[in] FormatArray

Адрес массива элементов WINBIO_UUID , определяющих форматы данных калибровки, поддерживаемые адаптером датчика. Адаптер подсистемы должен выбрать один из этих форматов для данных калибровки.

[in] FormatCount

Значение, указывающее количество идентификаторов UUID в параметре FormatArray .

[out] SelectedFormat

Адрес WINBIO_UUID элемента, в котором метод EngineAdapterSelectCalibrationFormat будет хранить UUID выбранного формата калибровки. Это должен быть один из идентификаторов UUID в параметре FormatArray .

[out] MaxBufferSize

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

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

Функция вернет одно из следующих значений HRESULT .

Код возврата Описание
S_OK
Операция успешно выполнена. Были заданы возвращаемые значения SelectedFormat и MaxBufferSize .
E_NOTIMPL
Адаптер подсистемы не требует динамической калибровки. Это не ошибка. Биометрическая служба преобразует это значение в S_OK, а биометрическая единица не будет использовать динамическую калибровку.
WINBIO_E_NO_SUPPORTED_CALIBRATION_FORMAT
Адаптер подсистемы требует динамической калибровки, но не поддерживает форматы калибровки, указанные в параметре FormatArray . (Адаптер подсистемы также должен возвращать этот код ошибки, если аргумент FormatCount равен нулю.) Этот код ошибки приведет к тому, что биометрическая служба зановит ошибку в журнал и прервет настройку биометрической единицы.
E_some_other_error
Любой другой код ошибки приведет к тому, что биометрическая служба зановит ошибку в журнал и прервет настройку биометрической единицы.

Комментарии

Этот метод вызывается один раз во время настройки биометрической единицы. После выбора формата калибровки его нельзя изменить.

Требования

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