ГОСТ Р ИСО/МЭК 19784-4— 2014
Значение Bk>SFPI_GUI_RESPONSE_PROGRESS_ABORT может быть возвращено только в ответ
на обратный вызов уведомления о событии выполнения ГИП. Это является показателем того, что ПФБ
должен прекратить выполнение процесса сбора биометрических данных и выдать код ошибки.
После такого ответа от ПБУ ожидается возвращение ошибки на первоначальный вызов от ПФБ.
Если возвращаемое ПБУ значение ответа отличается от допустимых значений, то ПФБ должен
прекратить выполнение процесса сбора биометрических данных и вызвать первоначальную функцию
вызова для возвращения кода ошибки. Какие-либо еще уведомления от функции обратного вызова о
событии выполнения ГИП от ПФБ по той же функции не ожидаются.
8.1.4 BioSFPI_GUI_PROGRESS_EVENT_HANDLER
Функция обратного вызова
typedef BioAPI^RETURN (BioAPI
•BioSFPI_GUl_PROGRESS_EVENT_HANDiiER)
BioAPl_UNIT_ID UnitlD,
const void ’GUIProgressEventHandlerCtx,
const BioAPl_GUI—BITMAP_ARRAY ’Bitmaps,
BioSFPI_GUI_RESPONSE ’Response);
Описание
Тип указателя функции ПБУ для функции обработчика событий ГИП. которая должна обрабатывать
обратные вызовы уведомления о событиях выполнения ГИП. приходящих от ПФБ. В целях получения
уведомлений о событиях выполнения ГИП. ПБУ должен зарегистрировать функцию обратного вызова
типа BioSFPI_GUI_PROGRESS_EVENT_HANDLER посредством предоставления адреса функции об
ратного вызова, параллельно с адресом контекста, при вызове BioSFPI_SubscribeToGUIEvents (8.2.16).
Инфраструктура совершает обратный вызов функции приложения данного типа каждый раз. когда
она получает входящий обратный вызов функции типа BioSPI_GUI_PROGRESS_EVENT_HANDLER. ко
торый она предоставляет ПФБ. Параметры функции обратного вызова (за исключением GUIProgressEv-
entHandlerCtx) должны быть установлены из параметров входящего обратного вызова с теми же имена
ми. Параметр GUIProgressEventHandlerCtx должен быть установлен из адреса контекста выполнения
ГИП. изначально предоставленного ПБУ при вызове функции BioSFPI_SubscribeToGUIEvents. а адрес
обратного вызова должен быть установлен из адреса обратного вызова выполнения ГИП. изначально
предоставленного ПБУ при вызове функции BioSFPI_SubscribeToGUIEvents.
ПФБ может создать событие выполнения ГИП только во время выполнения вызова функций BioS-
FPI_DataTransfer. BioSFPI_Play или какой-либо другой, которая включена в выполнение процесса сбора
биометрических данных. Они могут быть созданы в любое время, даже несколько раз. в течение любо го
процесса сбора биометрических данных.
Основная цель уведомления о событии выполнения ГИП - отправка ПБУ потоковых данных (в ка
честве серии битовых массивов), полученных биометрическим датчиком. Одним из возможных вариан
тов использования такой информации для ПБУ является предоставление битовых массивов субъекту
или оператору. ПБУ должен отвечать на каждое уведомление о событии выполнения ГИП. определяя
должно ли выполнение процесса сбора биометрических данных продолжено или прекращено (8.1.3).
Функция обработчика события выполнения ГИП и любая другая функция, вовлеченная (напрямую
или косвенно) данной функцией, не должны вызывать какую-либо функцию BioSPFI.
Если ПБУ возвращает значение, отличное от BioAPI_OK. то ПФБ должен прекратить текущий про
цесс сбора биометрических данных и возвратить код ошибки.
Параметры
UnitlD (входной) — ИД модуля биометрического датчика ПБУ. с которым связано событие ГИП.
GUIProgressEventHandlerCtx (входной) - контекст адреса, изначально предоставляемый прило
жением-подписчиком. как составная часть подписки на события ГИП.
Bitmaps (входной) - массив битов, содержащих иэображение(я) образцов, запись которых произ
ведена посредством выполнения процесса сбора биометрических данных, и которые предназначены
для представления субъекту или оператору. Указанный массив, как правило, содержит ноль либо один
битовый массив, но в случае, если ПФБ поддерживает мультимодальный сбор биометрических данных в
ходе единичной операции сбора данных, такой массив может содержать множество битовых массивов.
Response (входной) — значение, указывающее на ответ ПБУ на уведомление о событии выбора
ГИП (8.1.3).
6