ГОСТ Р ИСО/МЭК 19784-4— 2014
ставляот ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля
определяют один и тот же модуль BioAPI (8.2.4).
Параметры
Unitld (входной) — ИД модуля BioAPI. к которому обращаются для сбора биометрических данных;
Timeout (входной/выходной) — указатель на целое число, которое обозначает значение време
ни ожидания операции (в миллисекундах). Если время ожидания истекло, функция возвращает ошиб ку.
Данное значение может быть любым числом. Если ПБУ установлено нулевое значение, то данная
функция незамедлительно возвратится со значением, установленным на время ожидания, требуемое
для настройки присоединенного модуля BioAPI_Unit при условии, что такой биометрический датчик
поддерживает настройку. Если для биометрического датчика не предусмотрена настройка, то возвра
щаемое значение для времени ожидания будет 0.
Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип
ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все
остальные значения описывают тип ошибки.
Ошибки
_
ВioAPIERR_FUNCTION..NONSUPPORTED
BioAPIERR_UNIT_IN_USE
BioAPIERR_INVALID_UNIT..ID
BioAPI
err unit
_
not
_:
nserted
В iоАРIERR_CALIBRATION_NOT_SUCCESSFUL
BioAPIERR__TIMEOUT_EXPIRED
8.2.16 Функция BioSFPI_SubscribeToGUIEvents
BioAPI_R£TURN BioAPI BioSFPl_SubscribeToGUIEvents
(BioAPl_UNIT_ ID Unitld,
BioSFPI_GUI_PROGRESS_EVENT_HANDLER GUlProgressEventHandler.
const void *GUIProgressEventHandlerCtx);
Описание
Данная функция является необязательной и создает подписку на события ГИП для имеющегося
ПБУ. Поддержка подписок на события ГИП осуществляется ПБУ во время рабочего режима.
ПБУ предоставляет адреса функции обратного вызова для обработчика событий выполнения
ГИП. Все значения параметра, которые предоставляются в вызове данной функции, должны стать ча
стью подписки на события ГИП. поддерживаемой ПБУ.
Подписки на события ГИП. которые определяют сессию присоединения ПФБ. должны быть авто
матически удалены ПБУ после того, как сессия присоединения будет разорвана.
Адреса контекста, предоставленные в вызове, должны быть переданы ПФБ обратно ПБУ в после
дующих обратных вызовах к обработчикам событий. Настоящий стандарт не определяет для адресов
контекста какое-либо значение, но устанавливает для них соответствие требованиям некоторых ПФБ.
После нескольких вызовов функции, не должно появиться множество обработчиков событий вы
полнения ГИП. установленных для одного и того же ИД модуля ПБУ. Для любого входящего события ГИП
не будет ситуации двусмысленности к какому обработчику событий ГИП (если таковые существу ют) ПБУ
должен направить вызов.
П р и м е ч а н и е — Недопустимо наличие двух подписок с одинаковыми параметрами.
Данная функция вызывается только (для имеющегося ИД модуля ПБУ) в случае, если существует
хотя бы один вызов функции BioSFPI_BFPLoad (для такого УУИД ПФБД).
Параметры
Unitld (входной) — ИД модуля BioAPI. который может возвратить статус или информацию об об
ратном вызове данных:
GUlProgressEventHandler (входной) — адреса обратных вызовов функции ПБУ. на которые при
ходят уведомления о событиях выполнения ГИП от ПФБ;
16