ГОСТ Р ИСО/МЭК 19784-4—2014
Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип
ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все
остальные значения описывают тип ошибки.
Ошибки
BioAPIERR_USER_CANCElLED
BioAPIERR_F*JNC?ION.FAILED
BioAPIERR_FL*NCTION.NONSUPPORTED
8.2 Функции ПФБД
8.2.1 Функция BioSFPI_BSFPLoad
BioAPI_RETURN BioAPI BioSFPI_BSFPLoad
const BioAPIJJUID ‘BSFPUuid,
BioSFPI_EventHandler BioSFPINotifyCallback);
Описание
Данная функция инициализирует ПФБ. Инициализация включает в себя регистрацию обработчика
события ГИП для определенных ПФБ и предоставление возможности для всех событий. ПБУ может
предоставить функции обработчика событий возможность получения уведомлений о событиях. Многие
ПБУ могут независимо друг от друга одновременно загружать один и тот же ПФБ. и каждый ПБУ может
установить свой собственный обработчик событий. Все они будут получать уведомления о событиях.
Один либо разные обработчики событий могут быть использованы, если ПБУ загружает множество ПФБ.
ПБУ может установить сколько ему необходимо обработчиков для заданного ПФБ путем еди
ничного или множественных вызовов функции BioSFPI_BSFPLoad к такому ПФБ. Обработчик событий
определен адресом уведомления.
Когда в ПФБ происходит событие, он может отправить уведомление о событии в ПБУ посред
ством вызова обработчика событий ПБУ.
Если ПБУ установил несколько обработчиков событий, необходимо, чтобы каждый из них был вы
зван по одному за раз (в любом порядке, выбранном ПФБ). а не несколько одновременно.
Уведомление о событии может появиться в любое время: во время вызовов функции BioSPI или в
то время, когда вызовы функции BioSPI не выполняются. Разработчик приложения должен гарантиро
вать. что обратные вызовы будут правильно и безопасно обрабатываться приложением независимо от
того, когда приложение будет их получать.
П р и м е ч а н и е — В данном случав необходимо использовать технологию синхронизированных потоков и
порядка действий, сформированных кодом ПБУ в обработчиках событий.
Когда ПФБ загружен (BloSFPI_BSFPLoad). он должен незамедлительно вызвать событие
«вставить»(|ПвеП) для каждого имеющегося в наличие модуля BioAPI. Последнее позволит определить
ПБУ. что он может продолжить выполнение функции BioSFPI_UnitAttach. Если аппаратный компонент
для определенных функциональных возможностей не был подключен, то событие «insert» (вставить) не
может быть вызвано до тех пор. пока аппаратный компонент не будет включен.
Функция BioSFPI_UnitAttach может быть задействована несколько раз для каждого вызова функ
ции BioSFPI_BSFPLoad. Параметр BSFPUuid определяет задействованный ПФБ.
Параметр BioSFPINotifyCallback определяет функцию обратного вызова, которая была использо
вана для уведомления ПБУ о событиях типа BioAPI_EVENT. ПФБД должен возвратить данную инфор
мацию для дальнейшего использования.
Параметры
BSFPUuid (входной) — УУИД задействованного ПФБД. Используется для определения местопо
ложения элемента компонента в каталоге;
BioSFPINotifyCallback (входной)) — функциональный указатель на обработчика событий, который
управляет событиями типа BioAPI_ EVENT.
Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип
ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все
остальные значения описывают тип ошибки.
7