ПО ТЕХНИЧЕСКОМУ РЕГУЛИРОВАНИЮ И МЕТРОЛОГИИ

ГОСТ Р исо/мэк 19784-4—

2014

Информационные технологии БИОМЕТРИЯ

Биометрический программный интерфейс

Часть 4

Интерфейс поставщика функции биометрического

датчика

ISO/IEC 19784-4:2011 Information technology -Biometric application programming interface -Part 4:

Biometric sensor function provider interface (IDT)

Издание официальное

Москва

Стандартинформ

2016

Предисловие

1    ПОДГОТОВЛЕН Научно-исследовательским и испытательным центром биометрической техники Московского государственного технического университета имени Н.Э. Баумана (НИИЦ БТ МГТУ им. Н.Э.Баумана) на основе собственного аутентичного перевода на русский язык международного стандарта, указанного в пункте 4

2    ВНЕСЕН Техническим комитетом по стандартизации ТК 098 «Биометрия и биомониторинг»

3    УТВЕРЖДЕН И ВВЕДЕН В ДЕЙСТВИЕ Приказом Федерального агентства по техническому регулированию и метрологии от 11 ноября 2014 г. № 1570-ст

4    Настоящий стандарт идентичен международному стандарту ИСО/МЭК 19784-4:2011 «Информационные технологии. Биометрический программный интерфейс. Часть 4. Интерфейс поставщика функции биометрического датчика» (ISO/IEC 19784-4:2011 «Information technology — Biometric application programming interface — Part 4: Biometric sensor function provider interface»).

Наименование настоящего стандарта изменено относительно наименования указанного международного стандарта для приведения в соответствие с ГОСТ Р 1.5-2012 (пункт 3.5).

При применении настоящего стандарта рекомендуется использовать вместо ссылочных международных стандартов соответствующие им национальные стандарты, сведения о которых приведены в дополнительном приложении ДА

5    ВВЕДЕН ВПЕРВЫЕ

6    Следует обратить внимание на то, что некоторые элементы настоящего стандарта могут быть объектами получения патентных прав. Международная организация по стандартизации (ИСО) и Международная электротехническая комиссия (МЭК) не несут ответственности за установление подлинности каких-либо или всех таких патентных прав

Правила применения настоящего стандарта установлены в ГОСТ Р 1.0-2012 (раздел 8). Информация об изменениях к настоящему стандарту публикуется в ежегодном (по состоянию на 1 января текущего года) информационном указателе «Национальные стандарты», а официальный текст изменений и поправок — в ежемесячном информационном указателе «Национальные стандарты». В случае пересмотра (замены) или отмены настоящего стандарта соответствующее уведомление будет опубликовано в ближайшем выпуске ежемесячного информационного указателя «Национальные стандарты». Соответствующие информация, уведомление и тексты размещаются также в информационной системе общего пользования — на официальном сайте Федерального агентства по техническому регулированию и метрологии в сети Интернет (www.gost.ru)

© Стандартинформ, 2016

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

ГОСТ Р ИСО/МЭК 19784-4—2014

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_USER_CANCE1LED

В i ОАРIERR_FUNCTION_FAILED

BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2 Функции ПФБД

8.2.1 Функция BioSFPI_BSFPLoad

BioAPI_RETURN BioAPI BioSFPI_BSFPLoad

const BioAPI_UUID *BSFPUuid,

BioSFPI_EventHandler BioSFPlNotifyCallback);

Описание

Данная функция инициализирует ПФБ. Инициализация включает в себя регистрацию обработчика события ГИП для определенных ПФБ и предоставление возможности для всех событий. ПБУ может предоставить функции обработчика событий возможность получения уведомлений о событиях. Многие ПБУ могут независимо друг от друга одновременно загружать один и тот же ПФБ, и каждый ПБУ может установить свой собственный обработчик событий. Все они будут получать уведомления о событиях. Один либо разные обработчики событий могут быть использованы, если ПБУ загружает множество ПФБ.

ПБУ может установить сколько ему необходимо обработчиков для заданного ПФБ путем единичного или множественных вызовов функции BioSFPI_BSFPLoad к такому ПФБ. Обработчик событий определен адресом уведомления.

Когда в ПФБ происходит событие, он может отправить уведомление о событии в ПБУ посредством вызова обработчика событий ПБУ.

Если ПБУ установил несколько обработчиков событий, необходимо, чтобы каждый из них был вызван по одному за раз (в любом порядке, выбранном ПФБ), а не несколько одновременно.

Уведомление о событии может появиться в любое время: во время вызовов функции BioSPI или в то время, когда вызовы функции BioSPI не выполняются. Разработчик приложения должен гарантировать, что обратные вызовы будут правильно и безопасно обрабатываться приложением независимо от того, когда приложение будет их получать.

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

Когда ПФБ загружен (BioSFPI_BSFPLoad), он должен незамедлительно вызвать событие «BCTaBHTb»(insert) для каждого имеющегося в наличие модуля BioAPI. Последнее позволит определить ПБУ, что он может продолжить выполнение функции BioSFPlJUnitAttach. Если аппаратный компонент для определенных функциональных возможностей не был подключен, то событие «insert» (вставить) не может быть вызвано до тех пор, пока аппаратный компонент не будет включен.

Функция BioSFPlJUnitAttach может быть задействована несколько раз для каждого вызова функции BioSFPI_BSFPLoad. Параметр BSFPUuid определяет задействованный ПФБ.

Параметр BioSFPlNotifyCallback определяет функцию обратного вызова, которая была использована для уведомления ПБУ о событиях типа BioAPI_EVENT. ПФБД должен возвратить данную информацию для дальнейшего использования.

Параметры

BSFPUuid (входной) — УУИД задействованного ПФБД. Используется для определения местоположения элемента компонента в каталоге;

BioSFPlNotifyCallback (входной)) — функциональный указатель на обработчика событий, который управляет событиями типа BioAPI_ EVENT.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

7

Ошибки

В i ОАРIERR_MODULE_LOAD_FAIL BioAPIERR_INVALID_UUID

8.2.2    Функция BioSFPI_UnitAttach

BioAPI_RETURN BioAPI BioSFPI_UnitAttach

(BioAPI_UNIT_ID UnitID);

Описание

Данная функция создает сессию присоединения.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставленного ПБУ в качестве входного к данной функции, было таким же, как значение ИД модуля, который инфраструктура представила ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

UnitID (входное) — ИД модуля BioAPI, определенного предшествующим вызовом функции BioSF-PI_QueryUnits. ПФБД заполняет UnitID в поле Unitld каждого элемента BioAPI_UNIT_SCHEMA. Возвращаемое значение

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPIERR_INVALID_UNIT_ID

BioAPIERR_UNIT_IN_USE

8.2.3    Функция BioSFPI_UnitDetach

BioAPl_RETURN BioAPI BioSFPI_UnitDetach (BioAPI_UNIT_ID UnitID);

Описание

Данная функция создает сессию присоединения.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставленного ПБУ в качестве входного к данной функции, было таким же, как значение ИД модуля, который инфраструктура представила ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

UnitID (входное) — ИД модуля BioAPI, определенного предшествующим вызовом функции BioSF-PI_QueryUnits. ПФБД заполняет UnitID в поле Unitld каждого элемента BioAPI_UNIT_SCHEMA. Возвращаемое значение

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

ВiоАРIERR_INVALID_UNIT_ID

8.2.4    Функция BioSFPI_QueryUnits

BioAPI_RETURN BioAPI BioSFPI_QueryUnitS (const BioAPI_UUID *BSFPUuid,

BioAPI_UNIT_SCHEMA **UnitSchemaArray, uint32_t *NumberOfElements);

8

ГОСТ Р ИСО/МЭК 19784-4—2014

Описание

Данная функция возвращает массив схем модулей BioAPI (см. 7.55 в ИСО/МЭК 19784-1:2006), которые управляются заданным ПФБД и находятся в состоянии ввода.

Примечание — Когда ПБУ вызывает функцию ПФБ BioSFPI_QueryUnits, ПФБ выделяет память для данных, которые будут возвращены ПБУ. В некоторых схемах выполнения ПБУ передает данные приложению в точности, как возвращено ПФБ, так как приложение интерпретирует адрес так же, как и ПФБ, и сможет получить доступ к данным, которые размещены по данному адресу. В других схемах выполнения ПБУ будет необходимо переместить все данные, возвращенные ПФБ, во вновь выделенный блок памяти, доступный приложению, и вызвать функцию BioSPI_Free после копирования каждого блока памяти, но перед возвращением вызова функции BioAPI_QueryUnits. В первом случае, когда инфраструктура вызывает функцию BioSPI_Free, ПБУ совершает соответствующий вызов функции BioSFPI_Free. В последнем случае вызовы функции BioSPI_Free будут внутренне поддерживаться ПБУ. Тем не менее такие отличия в поведении ПБУ не заметны для инфраструктуры.

Когда блок памяти, содержащий массив, более не нужен ПБУ, посредством вызова функции BioS-FPI_Free ПБУ освобождает данный блок памяти. Блок памяти, на который указывает параметр Unit-Property внутри каждого элемента массива, должен быть также освобожден ПБУ через вызов функции BioSFPI_Free после того, как у ПБУ больше не будет в нем необходимости.

Данная функция должна вызываться только после того, как функция BioSFPI_Loadбыла вызвана для определенного ПФБ.

Не существует каких-либо требований, чтобы ИД модуля, который возвращается данной функцией для данного модуля BioAPI, был доступен по такому же значению ИД модуля от ПБУ к инфраструктуре. ПБУ может перевести любое значение ИД модуля (предоставленное ПФБ) в другое значение ИД перед тем, как предоставить его инфраструктуре. Цель такого перевода заключается в предотвращении дублирования ИД модулей внутри области ПБУ, что может произойти, когда ПБУ использует два или более ПФБ одинаковой категории либо, когда ПБУ использует ПФБД и одновременно напрямую управляет биометрическими датчиками.

Параметры

BSFPUuid (входной) — уникальный идентификатор для ПФБД, информация о котором должна быть возвращена;

UnitSchemaArray (входной) — указатель для адреса массива элементов типа BioAPI_UNIT_SCHE-МА (местоположение которых определено ПБУ), содержит информацию о схеме модуля.

NumberOfElements (входной) — указатель числа элементов в массиве, который управляется данным ПФБД и находится в состоянии ввода.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPIERR_INVALID_UUID

В i оАРIERR_MEMORY_ERROR

8.2.5 Функция BioSFPI_Free

BioAPI_RETURN BioAPI BioSFPI_Free

(void *Ptr);

Описание

Данная функция освобождает область памяти, на которую указывает параметр Ptr. Если параметр Ptr имеет нулевое значение, то никакие действия не выполняются. Если параметр Ptr не соответствует указателю, ранее возвращенному функциями BioSPFI, или если область памяти уже была освобождена вызовом функции BioSFPI_Free, то последствия вызова данной функции неопределенны.

Параметры

Ptr (входной) — указатель на освобождаемую память.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции.

9

8.2.6    Функция BioSFPI_ControlUnit

BioAPI_RETURN BioAPI BioSFPI_ControlUnit

(BioAPI_UNIT_ID UnitID,

uint32_t ControlCode,

const вiоAPI_DATA *lnputData,

BioAPl_DATA **OutputData);

Описание

Данная функция отправляет контрольные данные в модуль BioAPI и принимает от него данные статуса и операций. Содержание параметра ControlCode, входных данных и выходных данных будет определено в соответствующей спецификации для конкретного модуля BioAPI.

Данная функция выделяет область памяти, достаточную для размещения выходных данных, которые должны быть возвращены приложению, заполняет блок данными и записывает в поля «Длина» (Length,) и «Данные» (Data) структуры OutputData, размер и адрес блока памяти соответственно.

Блок памяти, возвращенный при вызове функции BioSFPI, должен быть освобожден приложением путем вызова функции BioSFPI_Free.

Функция представляет собой прозрачный канал для модуля BioAPI и может быть использована для любых целей, которые не могут быть реализованы стандартизированными функциями (например, управление установками контраста, установка фокуса и т.п.).

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который структура предоставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

UnitID (входной) — ИД модуля BioAPI, который был ранее определен ПФБД.

ControlCode (входной) — код функции в вызываемом модуле BioAPI;

InputData (входной) — адрес и длина буфера, содержащего данные, которые необходимо отправить в модуль BioAPI, относящийся к заданному параметру ControlCode;

OutputData (выходной) — указатель на структуру BioAPI_DATA. Являясь выходным параметром, он должен содержать адрес и длину данных буфера, который содержит данные, полученные от модуля BioAPI после обработки функции, определенной параметром ControlCode. Если функцией не распределен какой-либо блок памяти, то адрес должен быть установлен на пустой указатель, а длина - на ноль. Возвращаемое значение

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_MEMORY_ERROR В i ОАРIERR_INVALID_POINTER В i ОАРIERR_FUNCTION_FAILED BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2.7    Функция BioSFPI_Cancel

вiоAPI_RETURN BioAPI BioSFPl_Cancel (BioAPI_UNIT_ID UnitID);

Описание

Данная функция отменяет вызов, который находится в заблокированном состоянии, к модулю BioAPI. Функция не должна возвращаться до тех пор, пока заблокированный вызов не будет отменен.

Выполнение ПФД должно допускать, что данная функция может быть вызвана из ПБУ в любой момент. Заблокированный вызов к модулю BioAPI не должен препятствовать вызову данной функции.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который структура предоставляет ПБУ в исходном вызове к BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

ГОСТ Р ИСО/МЭК 19784-4—2014

Параметры

UnitID (входное) — ИД модуля BioAPI, в котором заблокированный вызов должен быть отменен.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPiERR_UNiT_iN__uSE — обозначает, что нижележащие слои не могут отменить заблокированный вызов должным образом. Либо необходимы действия со стороны программного обеспечения, либо со стороны аппаратных средств изготовителя для перезагрузки связанных компонентов

BioAPIERR_INVALID_UNIT_ID

В i ОАРIERR_UNIT_NOT_INSERTED

8.2.8    Функция BioSFPI_SetPowerMode

BioAPI_RETURN BioAPI BioSFPI_SetPowerMode

(BioAPI_UNIT_ID Unitld,

BioAPI_POWER_MODE PowerMode);

Описание

Данная функция устанавливает присоединенный модуль BioAPI в требуемый режим энергопотребления в том случае, если модуль поддерживает данный режим.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который структура предоставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

Unitld (входной) — ИД модуля BioAPI, для которого необходимо установить требуемый режим энергопотребления. Опция BioAPI_DONT_CARE недоступна для данной функции.

PowerMode (входной) — 32-х битное значение, указывающее режим энергопотребления, в который требуется перевести модуль BioAPI.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_FUNCTION_NOT_SUPPORTED

8.2.9    Функция BioSFPI_SetGUICallbacks

BioAPI_RETURN BioAPI BioSFPI_SetGUICallbacks

(BioAPI_UNIT_ID unitld,

вioAPI_GUI_STREAMING_CALLBACK GuiStreamingCallback,

Void *GuiStreamingCallbackCtx,

вiоAPl_GUl_STATE_CALLBACK GuiStateCallback,

Void *GuiStateCallbackCtx);

Описание

Данная функция позволяет ПБУ устанавливать параметры функции обратного вызова таким образом, что ПБУ может принять информационные данные путем получения от ПФБД как последовательного битового массива изображений, называемых потоковыми данными, так и информации о состоянии.

Примечание — Не все ПФБД поддерживают функцию предоставления потоковых данных.

Параметры

Unitld (входной) — ИД модуля BioAPI, который может возвратить информацию обратного вызова о статусе и данных;

GuiStreamingCallback (входной) — указатель на обратный вызов ПБУ для взаимодействия с представлением потоковых биометрических данных;

GuiStreamingCallbackCtx (входной) — указатель на контекстную информацию, которая была предоставлена ПБУ и будет представлена в обратном вызове;

GuiStateCallback (входной) — указатель на обратный вызов ПБУ для взаимодействия с изменениями состояния ГИП;

GuiStateCallbackCtx (входной) — указатель на контекстную информацию, которая была предоставлена ПБУ и будет представлена в обратном вызове.

Примечание 1 — Определения функциональных подтипов для BioAPI_GUI_STATE_CALLBACK и BioAPI_GUI_STREAMING_CALLBACK (см. 7.36 и 7.37 в ИСО/МЭК 19784-1:2006)

Примечание 2 — Определение интерфейса пользователя приведено в приложении С, раздел С.7.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_INVALID_POINTER

BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2.10    Функция BioSFPI_QueryFormatlnfo

ВiоAPI_RETURN BioAPI BioSFPI_QueryFormatInfо

(BioAPI_UNIT_ID Unitld,

BioAPI_UUID *FormatInfo);

Описание

Данная функция используется для получения через модуль биометрического датчика информации о том, какой тип формата данных он поддерживает. Описание, полученных УУИД, представлено в А.4 и В.4.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который инфраструктура предоставляет ПБУ в исходном вызове к BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

Unitld (входной) — ИД модуля BioAPI, к которому обращаются для сбора биометрических данных;

Formatlnfo (входной) — указатель буфера извлечения УУИД, который описывает формат данных, поддерживаемых модулем биометрического датчика.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2.11    Функция BioSFPI_GetPackets

вiоАРl_RETURN BioAPI BioSFPl_GetPackets

(BioAPI_UNIT_ID unitld,

вIOAPl_DATA *MemoryForTransfer,

12

ГОСТ Р ИСО/МЭК 19784-4—2014

uint32_t *PacketLength,

ВiОАРI_BIR_BIOMETRIC_DATA_FORMAT *BDBFormat) ;

Описание

Данная функция отправляет запрос ПФБД на заполнение инфраструктуры BioAPI_DATA, на которую ссылается параметр MemoryForTransfer, и запрос на возврат с длиной вставленного пакета в Раск-etLength. Память распределяется ПБУ по размерам, которые взяты из BioSFPI_UNIT_IMAGE_PROPER-TY_SCHEMA (приложение А) или BioSFPI_UNIT_SIGNATURE_PROPERTY_SCHEMA (приложение В).

Данная функция определяет модуль BioAPI_Unit и формат ББД, который будет возвращен одним или последовательностью вызовов функции BioSFPI_GetPackets. ПФБД может переписать параметр BDBFormat и возвратить другой формат, взамен запрашиваемого ПБУ.

ПБУ решает либо принять изменение формата, либо отменить операцию путем прекращения отправлений вызовов функции BioSFPI_GetPackets.

BDBFormat является идентификатором согласно ИСО/МЭК СТК 1 ПК 37 СД 9.

Выбранный формат ББД ограничен возможностями ПФБД для такого параметра Unitld (см. также BioSFPI_UNIT_IMAGE_PROPERTY_SCHEMA (приложение А) или BioSFPI_UNIT_SIGNATURE_PROP-ERTY_SCHEMA (приложение В)).

Примечание — Когда запрашивается множество последовательных пакетов с целью получения всех данных, например для процесса сбора биометрических данных, ПФБД должен возвратить пакеты в форматах и частях, которые могут быть обработаны ПБУ без детального знания характеристик ПФБД или модуля BioAPlJJnit. Архитектура ПФБД направлена на помощь в развитии менее детальных модулей BioAPlJJnit и более универсальных ПБУ.

ПБУ будет совершать взаимосвязанные вызовы функции BioSFPI_GetPackets до тех пор, пока ПФБД не сообщит «последний пакет» (last packet).

Принцип множественного буфера, заключающийся в увеличении производительности и скорости передачи данных ПБУ и ПФБД, может быть с легкостью осуществлен: во время совершения первого вызова функции BioSFPI_GetPackets в ПФБД, ПБУ может подготовить и распределить следующую часть передаваемой памяти. После того как возвратился первый вызов функции BioSFPI_GetPackets, ПБУ может незамедлительно совершить второй вызов функции BioSFPI_GetPackets, используя при этом заранее подготовленную память в инфраструктуре данных MemoryForDataTransfer. В то время как совершается второй вызов в ПФБД, возвращенная память первого вызова может быть обработана ПБУ и затем новая часть памяти может быть опять подготовлена для третьего вызова и так далее.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который инфраструктура предоставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

Unitld (входной) — ИД модуля BioAPI, к которому обращаются для сбора потоковых биометрических данных.

MemoryForTransfer (входной/выходной) — постоянный указатель, на который ссылается инфраструктура BioAPI_DATA, используюемая для передачи данных. ПФБД установит следующие данные в MemoryForTransfer, в зависимости от лимита длины в данной инфраструктуре, возвращая данные о длине (Приложение С);

PacketLength (выходной) — размер пакета (в байтах), перемещенного в структуру BioAPI_DATA;

BDBFormat (входной/выходной) — владелец формата и тип формата ББД, который будет возвращен.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPljDK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2.12 Функция BioSFPI_DataTransfer

вiоАРl_RETURN BioAPI BioSFPl_DataTransfer

(BioAPI_UNIT_ID Unitld,

13

uint32_t *StreamID,

BioAPl_DATA *SensorData,

ВiОАРI_BIR_BIOMETRIC_DATA_FORMAT *BDBFormat) ;

Описание

Данная функция извлекает базы данных, полученные в результате сбора. Данная функция определяет модуль BioAPNJnit и возвращаемый формат баз данных.

Данная функция направляет запрос ПФБД на заполнение инфраструктуры BioAPI_DATA, на которую ссылается параметр SensorData. Память распределяется ПБУ по размерам, взятым из BioSF-PI_UNIT_IMAGE_PROPERTY_SCHEMA (приложение А) или BioSFPI_UNIT_SIGNATURE_PROPERTY_ SCHEMA (приложение В).

ПФБД может переписать параметр BDBFormat и возвратить другой формат взамен запрашиваемого ПБУ.

ПБУ решает либо принять изменение формата, либо отменить операцию путем отправления функции BioSFPI_Cancel.

BDBFormat является идентификатором, согласно ИСО/МЭК СТК 1 ПК 37 СД 9.

Выбранный формат ББД ограничен возможностями ПФБД для такого параметра Unitld (см. также BioSFPI_UNIT_IMAGE_PROPERTY_SCHEMA (приложение А) или BioSFPI_UNIT_SIGNATURE_PROP-ERTY_SCHEMA (приложение В)).

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который инфраструктура предоставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

Unitld (входной) — ИД модуля BioAPI, к которому обращаются для сбора биометрических данных;

StreamID (входной) — ИД доступа к потоковой функции, которая обеспечивается системным интегратором на любой имеющейся платформе, на которой возможна передача потоковых данных между ПФБД и ПБУ;

SensorData (выходной) — указатель на структуру извлечения биометрических данных;

BDBFormat (входной /выходной) — владелец формата и тип формата ББД, который будет возвращен.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2.13 Функция BioSFPI_SetlndicatorStatus

вiоАРl_RETURN BioAPI BioSFPl_SetlndicatorStatus

(BioAPI_UNIT_ID Unitld,

BioAPl_lNDlCATOR_STATUS indicatorStatus);

Описание

Данная функция устанавливает выбранный модуль BioAPI на требуемый статус индикатора при условии, что модуль BioAPI его поддерживает.

После BioAPI_INDICATOR_ACCEPT либо в случае, если BioAPI_INDICATOR_REJECT установлен на параметр IndicatorStatus, статус не будет изменен до тех пор, пока приложение не установит другое значение.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который инфраструктура предоставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

ГОСТ Р ИСО/МЭК 19784-4—2014

Параметры

Unitld (входной) — ИД модуля BioAPI, для которого необходимо установить статус индикатора. Опция BioAPI_DONT_CARE недоступна для данной функции;

IndicatorStatus (входной) — значение, на которое должен быть установлен статус индикатора модуля BioAPI.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

BioAPIERR_FUNCTION_NOT_SUPPORTED

BioAPIERR_INVALID_UNIT_ID

BioAPIERR_UNIT_NOT_INSERTED

BioAPIERR_UNIT_IN_USE

8.2.14    Функция BioSFPI_GetlndicatorStatus

вiоAPI_RETURN BioAPI BioSFPI_GetIndicatorStatus (BioAPI_UNIT_ID Unitld,

BioAPI_INDICATOR_STATUS *IndicatorStatus);

Описание

Данная функция возвращает статус индикатора модуля BioAPI, но только в том случае, если модуль поддерживает данный режим.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который инфраструктура предоставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

Unitld (входной) — ИД модуля BioAPI, для которого статус индикатора должен быть получен. Опция BioAPI_DONT_CARE недоступна для данной функции;

IndicatorStatus (выходной) — значение статуса индикатора модуля BioAPI.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i оАРIERR_FUNCTION_NOT_SUPPORTED BioAPIERR_INVALID_UNIT_ID В i ОАРIERR_UNIT_NOT_INSERTED BioAPIERR_UNIT_IN_USE

8.2.15    Функция BioSFPI_CalibrateSensor

BioAPI_RETURN BioAPI BioSFPl_CalibrateSensor (BioAPI_UNIT_ID Unitld, int32_t *Timeout);

Описание

Данная функция выполняет калибровку подключенного датчика модуля BioAPI, но только в том случае, если модуль датчика поддерживает калибровку.

Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в качестве входного к данной функции, совпадало со значением ИД модуля, который инфраструктура предо-

15

ставляет ПБУ в исходном вызове функции BioSPI_BSPAttach при условии, что два значения ИД модуля определяют один и тот же модуль BioAPI (8.2.4).

Параметры

Unitld (входной) — ИД модуля BioAPI, к которому обращаются для сбора биометрических данных; Timeout (входной/выходной) — указатель на целое число, которое обозначает значение времени ожидания операции (в миллисекундах). Если время ожидания истекло, функция возвращает ошибку. Данное значение может быть любым числом. Если ПБУ установлено нулевое значение, то данная функция незамедлительно возвратится со значением, установленным на время ожидания, требуемое для настройки присоединенного модуля BioAPI_Unit при условии, что такой биометрический датчик поддерживает настройку. Если для биометрического датчика не предусмотрена настройка, то возвращаемое значение для времени ожидания будет 0.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_FUNCТION_NOT_SUPPORTED

BioAPIERR_UNIT_IN_USE

BioAPIERR_INVALID_UNIT_ID

В i ОАРIERR_UNIT_NOT_INSERTED

В i ОАРIERR_CALIBRATION_NOT_SUCCESSFUL

В i ОАРIERR_TIMEOUT_EXPIRED

8.2.16 Функция BioSFPI_SubscribeToGUIEvents

ВiоАРI_RETURN BioAPI BioSFPI_SubscribeToGUIEvents (BioAPI_UNIT_ ID Unitld,

вioSFPl_GUl_PROGRESS_EVENT_HANDLER GUlProgressEventHandler, const void *GUlProgressEventHandlerCtx);

Описание

Данная функция является необязательной и создает подписку на события ГИП для имеющегося ПБУ. Поддержка подписок на события ГИП осуществляется ПБУ во время рабочего режима.

ПБУ предоставляет адреса функции обратного вызова для обработчика событий выполнения ГИП. Все значения параметра, которые предоставляются в вызове данной функции, должны стать частью подписки на события ГИП, поддерживаемой ПБУ.

Подписки на события ГИП, которые определяют сессию присоединения ПФБ, должны быть автоматически удалены ПБУ после того, как сессия присоединения будет разорвана.

Адреса контекста, предоставленные в вызове, должны быть переданы ПФБ обратно ПБУ в последующих обратных вызовах к обработчикам событий. Настоящий стандарт не определяет для адресов контекста какое-либо значение, но устанавливает для них соответствие требованиям некоторых ПФБ.

После нескольких вызовов функции, не должно появиться множество обработчиков событий выполнения ГИП, установленных для одного и того же ИД модуля ПБУ. Для любого входящего события ГИП не будет ситуации двусмысленности к какому обработчику событий ГИП (если таковые существуют) ПБУ должен направить вызов.

Примечание — Недопустимо наличие двух подписок с одинаковыми параметрами.

Данная функция вызывается только (для имеющегося ИД модуля ПБУ) в случае, если существует хотя бы один вызов функции BioSFPI_BFPLoad (для такого УУИД ПФБД).

Параметры

Unitld (входной) — ИД модуля BioAPI, который может возвратить статус или информацию об обратном вызове данных;

GUlProgressEventHandler (входной) — адреса обратных вызовов функции ПБУ, на которые приходят уведомления о событиях выполнения ГИП от ПФБ;

ГОСТ Р ИСО/МЭК 19784-4—2014

Содержание

1    Область применения....................................................................................................................................1

2    Соответствие.................................................................................................................................................1

3    Нормативные ссылки....................................................................................................................................1

4    Термины и определения...............................................................................................................................2

5    Обозначения и сокращения, определения структур данных и коды ошибок...........................................2

5.1    Обозначения и сокращения...................................................................................................................2

5.2    Определения структур данных и коды ошибок....................................................................................2

6    Архитектура интерфейса.............................................................................................................................2

7    Выбор и загрузка ПФБ и модулей BioAPI_Units.........................................................................................3

7.1    Получение информации о ПФБ и модулях BioAPNJnits.....................................................................3

7.2    Загрузка ПФБ..........................................................................................................................................4

8    Определение ИПФБД...................................................................................................................................5

8.1    Инфраструктуры данных ИПФБД..........................................................................................................5

8.2    Функции ПФБД........................................................................................................................................7

Приложение А (обязательное) Модули регистрации изображений биометрических датчиков...............18

Приложение В (обязательное) Модули биометрического датчика подписи.............................................23

Приложение С (справочное) Получение биометрических данных посредством ИПФБД........................29

Приложение ДА (справочное) Сведения о соответствии ссылочных международных стандартов

национальным стандартам Российской Федерации......................................................31

Библиография................................................................................................................................................32

ГОСТ Р ИСО/МЭК 19784-4—2014

GUIProgressEventHandlerCtx (входной) — адреса контекстов, которые передаются ПФБ обратно ПБУ на каждый обратный вызов обработчика событий ГИП.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_INVALID_POINTER

BioAPIERR_FUNCTION_NOT_SUPPORTED

8.2.17 Функция BioSFPI_UnsubscribeFromGUIEvents

ВiоAPI_RETURN BioAPI BioSFPI_UnsubscribeFromGUIEvents

(BioAPI_UNIT_ID Unitld,

ВiоSFPI_GUI_PROGRESS_EVENT_HANDLER GUlProgressEventHandler

const void *GUIProgressEventHandlerCtx);

Описание

Данная функция является необязательной и удаляет подписку на события ГИП, созданную ранее посредством вызова функции BioSFPI_SubscribeToGUIEvents. Удаляется конкретная подписка, описание которой точно соответствует параметрам вызова.

Примечание —Даже при наличии только одной подписки вызов к данной функции не удаляет данную подписку на события ГИП, если параметры вызова не имеют точно таких же значений, как и в вызове функции BioSFPI_SubscribeToGUIEvents, для которых такая подписка была создана. ПБУ необходимо запомнить значение данных параметров.

У ПБУ нет необходимости вызова данной функции, так как все подписки на события ГИП для имеющегося ИД модуля автоматически уничтожаются ПБУ, после того как сессия присоединения была разорвана. Данная функция может быть использована, когда ПБУ необходимо изменить текущие подписки на события ГИП, но необходимости в разрыве сессии присоединения нет.

Данная функция вызывается только (для имеющегося ИД модуля ПБУ), если существует хотя бы один вызов функции BioSFPI_BFPLoad (для такого УУИД ПФБД).

Параметры

Параметры данной функции имеют то же значение, что и параметры функции BioSFPI_Subscri-beToGUIEvents с теми же именами, и используются ПФБ для определения имеющейся подписки на события ГИП, которую необходимо удалить.

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

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

Ошибки

В i ОАРIERR_INVALID_POINTER

BioAPIERR_FUNCTION_NOT_SUPPORTED

17

Введение

Настоящий стандарт определяет интерфейс низкого уровня, который позволяет модулю поставщика биометрической услуги (ПБУ) (ИСО/МЭК 19784-1) взаимодействовать с биометрическими датчиками от различных изготовителей [модуль поставщика функции биометрического датчика (ПФБД)], используя только спецификацию стандартизированного интерфейса. Биометрический датчик — физическое устройство с программным обеспечением. Интерфейс позволяет биометрическому датчику взаимодействовать с любым разработанным ПБУ, чтобы обращаться с технологией, поддерживаемой данным датчиком. Это позволяет модулю ПБУ быть независимым от деталей фактического датчика, но при этом оставаться зависимым от биометрической модальности, которую поддерживает датчик (палец, лицо, вена, и т. д.).

Биометрические датчики различаются по принципам работы. Форматы данных также сильно различаются в зависимости от биометрической особенности и типа датчика. В целях удовлетворения различных требований для основного поставщика функции в обязательные приложения настоящего стандарта включены определенные функции и инфраструктуры данных для типовых классов устройства датчика или биометрических модальностей. Целью настоящего стандарта является добавление дополнительных нормативных требований для случаев, когда существующие приложения не удовлетворяют требованиям типового класса датчика.

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

Главной функцией модуля ПБУ, выполняющего сбор биометрических данных, является создание полной записи биометрической информации (ЗБИ) для возврата к биометрическому приложению (как правило, посредством инфраструктуры BioAPI).

Главной функцией ПФБД является сбор и возврат данных в идентифицированном формате или как единого массива данных (используя функцию BioSFPI_DataTransfer), или как ряда пакетов (используя функцию BioSFPI_GetPackets), содержащих записанную информацию, либо посредством потокового интерфейса (приложение С).

ПБУ ответственен за перевод таких данных в биометрический блок данных (ББД) в пределах ЗБИ для возврата посредством интерфейса поставщика услуги (ИПУ).

Дополнительные функции имеют отношение к контролю биометрического датчика и параметров его операций.

IV

НАЦИОНАЛЬНЫЙ СТАНДАРТ РОССИЙСКОЙ ФЕДЕРАЦИИ

Информационные технологии БИОМЕТРИЯ Биометрический программный интерфейс Часть 4

Интерфейс поставщика функции биометрического датчика

Information technology. Biometrics.

Biometric application programming interface. Part 4.

Biometric sensor function provider interface

Дата введения — 2016—01—01

1    Область применения

Настоящий стандарт определяет интерфейс биометрического датчика для поставщика биометрической услуги (ПБУ), который определен в ИСО/МЭК 19784-1. Интерфейс осуществляет поддержку ПБУ, который настроен на предоставление функций интерфейса поставщика услуги (ИПУ) BioAPI, и в то же время освобождает ПБУ от деятельности по управлению оборудованием. В настоящем стандарте рассматривается интерфейс, который может быть использован всеми типами биометрических датчиков, включая датчики потоковой передачи изображений (инфракрасный, лица, радужной оболочки глаза, пальца и т. д.), датчики потоковой передачи голоса и датчики подписи (цифровые планшеты, применяемые для сбора динамических данных подписи).

В настоящем стандарте не рассматривается определение требований безопасности и конфиденциальности при сборе и передаче биометрических данных через интерфейс поставщика функции биометрического датчика (ИПФБД).

2    Соответствие

ПФБД должен поддерживать все функции, указанные в разделе 8 и приложениях А и В настоящего стандарта. Для некоторых функций ошибка BioAPIERR_FUNCTION_NOT_SUPPORTED, которая возвращается при вызове функции, является допустимой. Остальные функции должны быть преобразованы согласно описанию (в случае если возвращается другая ошибка).

3    Нормативные ссылки

В настоящем стандарте использованы нормативные ссылки на следующие стандарты, которые необходимо учитывать при использовании настоящего стандарта (в случае ссылок на документы, у которых указана дата утверждения, необходимо пользоваться только указанной редакцией, в случае, когда дата утверждения не приведена — последней редакцией ссылочных документов, включая любые поправки и изменения к ним):

ИСО/МЭК 19784-1, Информационные технологии. Биометрический прикладной программный интерфейс. Часть 1. Спецификация биометрического программного интерфейса (ISO/IEC 19784-1, Information technology — Biometric application programming interface — Part 1: BioAPI specification)

ИСО/МЭК 19794-7, Информационные технологии. Форматы обмена биометрическими данными. Часть 7. Данные динамики подписи (ISO/IEC 19794-7, Information technology — Biometric data interchange formats — Part 7: Signature/sign time series data)

Издание официальное

4 Термины и определения

В настоящем стандарте применены термины и определения, установленные в ИСО/МЭК 19784-1, а также следующие термины с соответствующими определениями.

Примечание — Названия функций и элементов данных не включены в данный раздел, а их определения приведены в тексте настоящего стандарта;

4.1    поставщик функции биометрического датчика; ПФБД (Biometric Sensor Function Provider; BSFP): Компонент BioAPI, который соединен с ПБУ посредством его интерфейса, в целях предоставления управления информацией от биометрического датчика.

Примечание — В качестве биометрического датчика может выступать камера, биометрический сканер отпечатков пальцев, биометрический сканер радужной оболочки глаза, биометрический сканер лица, либо биометрический сканер подписи, давления или звука, либо какой-либо другой тип биометрического датчика;

4.2    интерфейс поставщика функции биометрического датчика; ИПФБД (Biometric Sensor Function Provider Interface; BSFPI): Интерфейс ПБУ к ПФБД, который поддерживает функции, необходимые для предоставления биометрических данных и управления самим ПФБД и относящимися к нему устройствам.

4.3    пакет (packet): Фрагмент ББД, проходящий через ИПФБД (BSFPI)¹) как результат единичного вызова функции BioSFPI_GetPackets.

4.4    потоковые данные (streaming data): Данные, проходящие через интерфейс от источника, который непрерывно функционирует.

5 Обозначения и сокращения, определения структур данных и коды ошибок

5.1 Обозначения и сокращения

программный интерфейс приложений (Application Programming Interface);

блок биометрических данных (Biometric Data Block);

поставщик функции BioAPI (BioAPI Function Provider);

поставщик биометрической услуги (Biometric Service Provider);

интерфейс поставщика функции биометрического датчика (Biometric Sensor Function Provider Interface);

интерфейс поставщика функции (Function Provider Interface);

идентичность/идентификация/идентификатор (Identity/ldentification/ Identifier);

интерфейс поставщика услуги (Service Provider Interface);

стандарт красный зеленый голубой (Standard Red Green Blue) (cm. ITU-R ВТ.709-5);

универсальный уникальный идентификатор (Universally Unique Identifier).

5.2 Определения структур данных и коды ошибок

Определения структур данных и коды ошибок, примененные в настоящем стандарте, определены в ИСО/МЭК 19784-1.

6 Архитектура интерфейса

6.1 ИСО/МЭК 19784-1:2006 определяет интерфейс верхнего уровня инфраструктуры BioAPI, который используется биометрическим приложением для взаимодействия с ПБУ, либо с биометрическим датчиком напрямую, либо через ПБУ (см. рисунок 1 и рисунок 2 в ИСО/МЭК 19784-1:2006).

^ В оригинале международного стандарта ИСО/МЭК 19784-4: 2011 допущена опечатка — вместо «BSFPI» указано «SFPI».

2

ГОСТ Р ИСО/МЭК 19784-4—2014

6.2 ИПФБД содержит два типа функций:

6.2.1    Общие функции управления ПФБ, которые вызывают ПБУ для управления ПФБ и соотносящиеся с ним модули BioAPI. Такие функции напрямую не связаны с функциями ИПУ.

-    функция BioSFPI_BSFPLoad (функция загрузки ПФБД (см. 7 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPNJnitAttach (функция подключения модуля, вызываемая в контексте BioAPI_ BSPAttach и BioSPI_BSPAttach (см. 8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPNJnitDetach (функция отключения модуля, вызываемая в контексте BioAPI_ BSPDetach и BioSPI_BSPDetach (см. 8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_QueryUnits (функция запроса модулей, напрямую связана с функцией ИПУ BioSPI_QueryUnits, которая связана с функцией ПИП BioAPI_QueryUnits (см. 8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_Free (функция освобождения памяти, отношение к соответствующему вызову ПИП зависит от поведения ПБУ — в случае, когда ПБУ копирует данные, для которых ПФБ выделил память, он может незамедлительно отправить BioSFPI_Free в ПФБ, в противном случае, ПФБ вызовет указанную функцию, когда ему самому необходимо будет освободить память для этих данных).

6.2.2    Функции управления модулем, которые вызываются ПБУ для прямого управления модулями BioAPI. Такие функции напрямую связаны с функциями ИПУ.

-    функция BioSFPI_ControlUnit (функция контроля модуля, напрямую связана с функцией ИПУ BioSPI_ControlUnit, которая связана с функцией ПИП BioAPI_ControlUnit (см. 8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_Cancel (функция отмены, может быть вызвана при соответствующих вызово-вах ИПУ либо приложений, но также она может быть вызвана и при отсутствии соответствующего запроса от инфраструктуры BioAPI либо приложения (см. 8 и 9 из ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_SetPowerMode (функция выбора режима питания, напрямую связана с функцией ИПУ BioSPI_SetPowerMode, которая связана с функцией ПИП BioAPI_SetPowerMode (см. 8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_SetGUICallbacks (функция обратного вызова ГИП, напрямую связана с функцией ИПУ BioSPI_SetGUICallbacks, которая связана с функцией ПИП BioAPI_SetGUICallbacks (см.8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_SetlndicatorStatus (функция устанавливающая состояние индикатора, напрямую связана с функцией ИПУ BioSPI_SetlndicatorStatus, которая связана с функцией ПИП BioAPI_Setln-dicatorStatus (см.8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_GetlndicatorStatus (функция получения состояния индикаторы, напрямую связана с функцией ИПУ BioSPI_GetlndicatorStatus, которая связана с функцией ПИП BioAPI_Getlndica-torStatus (см.8 и 9 в ИСО/МЭК 19784-1:2006));

-    функция BioSFPI_CalibrateSensor (функция калибровки датчика, напрямую связана с функцией ИПУ BioSPI_CalibrateSensor, которая связана с функцией ПИП BioAPI_CalibrateSensor (см.8 и 9 в ИСО/ МЭК 19784-1:2006).

Следующие функции имеют высокую значимость для интерфейса между ПБУ и ПФУ, но они напрямую не соответствуют какой-либо функции через ИПУ между ПБУ и инфраструктурой (либо приложением для бесструктурных операций):

-    функция BioSFPI_QueryFormatlnfo (функция запроса информации о формате, не связана с ИПУ);

-    функция BioSFPI_ActivateSensor (функция активации датчика, не связана с ИПУ);

-    функция BioSFPI_GetPackets (функция получения пакетов, не связана с ИПУ);

-    функция BioSFPI_DataTransfer (функция передачи данных, не связана с ИПУ);

-    функция BioSFPI_SubscribeToGUIEvents (функция, подписывающая на события ГИП, не связана сИПУ);

-    Функция BioSFPlJJnsubscribeFromGUIEvents (функция, отписывающая от событий ГИП, не связана с ИПУ).

7 Выбор и загрузка ПФБ и модулей BioAPI_Units

7.1 Получение информации о ПФБ и модулях BioAPMJnits

Реестр компонентов содержит информацию о инфраструктуре BioAPI, ПБУ и ПФБ (см. 6.3 в ИСО/МЭК 19784-1:2006).

3

Информация о ПФБ содержится в инфраструктуре под названием BioAPI_BFP_SCHEMA (см. 7.3 в ИСО/МЭК 19784-1:2006).

BioAPI_BFP_SCHEMA содержит элементы данных BFPPropertylD и BFPProperty. Элемент данных BFPPropertylD является УУИД, определяющий тип инфраструктуры данных для BFPProperty.

Каждый ПФБ, который соответствует требованиям ИСО/МЭК 19784-1 и настоящего стандарта, должен предоставлять стандартизированные элементы данных соответствующих BFPPropertylD и BFPProp-ertySchema. Два элемента данных BSFPPropertyIDs и два связанных элемента данных BSFPPropertySche-mas определены в приложениях А и В. Приложение А определяет элемент данных BSFPPropertySchema, применимый для модулей регистрации изображений биометрических датчиков, а приложение В — для модулей биометрического датчика подписи. Последние могут быть использованы в вызовах функций (ИСО/МЭК 19784-1) в качестве элементов данных BFPPropertyIDs и BFPPropertySchemas.

Информация, представленная в элементе данных BFPPropertySchema, сохраняется при установке ПФБ (см. 6.4 в ИСО/МЭК 19784-1:2006) в реестре компонентов.

Приложение может получить указанную информацию посредством вызова функций BioAPI_ EnumBFPs и BioAPI_QueryBFPs (см. 8.1.10 и 8.1.11 в ИСО/МЭК 19784-1:2006).

ПБУ может получить указанную информацию при помощи механизма обратной связи BioSPI_ BFP_ENUMERATION_HANDLER (см. 9.2.2 в ИСО/МЭК 19784-1:2006).

Приложение может извлечь информацию обо всех модулях BioAPlJJnits, которые поддерживаются определенным ПБУ, посредством вызова функции BioAPI_Queryllnits (см. 8.1.9 в ИСО/МЭК 19784-1:2006). Данная функция выполняется даже в том случае, если сессия присоединения еще не установлена.

ПБУ может просматривать реестр компонентов по отношению ко всем установленным ПФБ при помощи механизма обратной связи BioSPI_BFP_ENUMERATION_HANDLER. ПБУ анализирует элемент данных BFPPropertySchemas и определяет ПФБ, для которых он может осуществить поддержку.

Примечание — Критерии, для принятия подобного решения, не рассматриваются в настоящем стандарте.

Во время вызова функции BioSPI_QueryUnits ПБУ может загрузить поддерживаемые ПФБ. В ответ на вызов функции BioSFPI_QueryUnits к ПБУ, загруженный ПФБ автоматически определитяет поддерживаемые модули BioAPI_Units и сообщает о поддерживаемых модулях BioAPI_UNIT_SCHEMAs.

ПБУ может создать список всех элементов данных BFPUuids и UnitIDs поддерживаемых устройств для каждого ПФБ. Дополнительная информация может находиться в параметре UnitManagerUuid модуля BioAPI_UNIT_SCHEMA.

7.2 Загрузка ПФБ

7.2.1    Загрузка ПФБ в случае присоединения к неопределенному модулю BioAPlJJnit

В настоящем пункте описано, каким образом ПФБ загружается в случае, если приложение не выбирает определенный модуль BioAPlJJnit в вызове функции BioAPI_Attach (в случае, если приложение выбирает определенный модуль BioAPlJJnit, см. 7.2.2).

В данном случае приложение вызывает функцию BioAPI_BSPAttach со значением BioAPI_DONT_ CARE в определенном элементе параметра UnitList.

Затем ПФБ производит действия, описанные в 7.1, при помощи механизма обратной связи BioS-PI_BFP_ENUMERATION_HANDLER, с последующим вызовом функции BioSFPI_QueryUnits. Таким образом, ПБУ получает список всех поддерживаемых модулей и поддерживаемых ими ПФБ. ПБУ выбирает один из модулей BioAPI_Units, а затем загружает соответствующий ПФБД и завершает операцию вызовом функции BioSFPI_BSFPLoad с последующим вызовом функции BioSFPI_BSFPAttach.

Примечание — Критерии, используемые для определения одного из поддерживаемых модулей Bio-API_Units, не рассматриваются в настоящем стандарте.

7.2.2    Загрузка ПФБ при присоединении к определенному модулю BioAPlJJnit

После вызова функции BioAPI_BSPLoad инфраструктура должна загрузить ПБУ (если поддерживается) и запустить функцию BioSPI_BSPLoad.

В свою очередь, приложение вызывает функцию BioAPI_QueryUnits для определения поддерживаемых таким ПБУ модулей и затем вызывает функцию BioAPI_Attach, задавая определенный модуль, который оно намерено использовать. Приложение получает элемент данных UnitSchemaArray от функции BioAPI_QueryUnits, который позволяет просмотреть информацию о модуле BioAPlJJnit. Приложение выбирает параметр Unitld, с которым ему необходимо установить связь, и вызывает функцию BioAPI_BSPAttach. Одновременно ПБУ может принять решение загрузить соответствующий ПФБ, ис-

ГОСТ Р ИСО/МЭК 19784-4—2014

ходя из списка, построенного как описано в 7.1, либо посредством анализа параметра UnitManagerUuid из модуля BioAPI_UNIT_SCHEMA.

Если ПБУ в состоянии поддержать хотя бы один ПФБД, который поддерживает запрашиваемый модуль, то такой ПБУ продолжает действовать согласно 7.1. Если ПБУ не сможет поддержать ПФБД, то он возвращает ошибку. При наличии множественного выбора ПФБД для выбранного модуля, ПБУ сделает выбор (критерии выбора не стандартизированы).

8 Определение И ПФБД

8.1    Инфраструктура данных ИПФБД

8.1.1    Коды контроля

Функция BioSFPI_ControlUnit использует 32-х битные значения в качестве кодов для индикации определенной к выполнению операции.

В целях предотвращения конфликтов между стандартизированными и определенными изготовителем кодами, контрольные коды структурированы.

Верхние 16 битов используются для структурирования цели кодов контроля. Нижние 16 битов используются для определения кодов контроля для каждой категории.

Следующие три категории стандартизированы:

ttdefme BioSFPl_BFPControlCode (0x8000)

ttdefme BioSFPl_BioAPlUnitControlCode (0x4000)

ttdefme BioSFPl_VendorSpecifLcControlCode (0x1000)

Все остальные значения категорий зарезервированы для последующего использования.

8.1.2    BioSFPI_EventHandler

В данном пункте определен интерфейс обработчика событий для получения асинхронных уведомлений о событиях типа BioAPI_EVENT из модуля BioAPI. Пример событий включает установку либо удаление модуля BioAPI (например, установка или извлечение биометрического датчика).

Данный обработчик событий направляется в ПФБД во время выполнения функции BioSFPI_BFPLoad. Это единственный обработчик событий, в котором все модули BioAPI, управляемые таким ПФБД, должны использоваться для уведомления ПБУ о типах событий, происходящих в загруженном ПФБД:

typedef BioAPI_RETURN (BioAPI *BioSFPI_EventHandler)

(const BioAPI_UUID *BSFPUuid,

BioAPI_UNIT_ID UnitID,

BioAPl_UNIT_SCHEMA *UnitSchema,

BioAPl_ EVENT EventType);

BSFPUuid (входной) — УУИД ПФБД, который инициирует событие.

UnitID (входной) — ИД модуля BioAPI (биометрического датчика), связаннего с событием.

UnitSchema (входной) — указатель на схему модуля BioAPI, связанного сданным событием.

EventType (входной) — тип произошедшего события BioAPI_ EVENT.

8.1.3    Параметр BioSFPI_GUI_RESPONSE

Параметр определяющий список возможных действий, которые будут выполняться ПФБ, после того как функция обратного вызова уведомления о событии выполнения ГИП возвратила управление ПФБ. Перед возвращением из функции обратного вызова ПБУ присваивает значение данного типа выходному параметру функции обратного вызова (параметр Response).

typedef uint8_t BioSFPI_GUI_RESPONSE;

ttdefine ВiOSFPI_GUI_RESPONSE_PROGRESS_CONTINUE(1) ttdefine BioSFPI_GUI_RESPONSE_PROGRESS_ABORT (2)

Значение BioSFPI_GUI_RESPONSE_PROGRESS_CONTINUE может быть возвращено только в ответ на обратный вызов уведомления о событии выполнения ГИП. Это является показателем того, что ПФБ должен продолжить выполнение процесса сбора биометрических данных.

5

Значение BioSFPI_GUI_RESPONSE_PROGRESS_ABORT может быть возвращено только в ответ на обратный вызов уведомления о событии выполнения ГИП. Это является показателем того, что ПФБ должен прекратить выполнение процесса сбора биометрических данных и выдать код ошибки. После такого ответа от ПБУ ожидается возвращение ошибки на первоначальный вызов от ПФБ.

Если возвращаемое ПБУ значение ответа отличается от допустимых значений, то ПФБ должен прекратить выполнение процесса сбора биометрических данных и вызвать первоначальную функцию вызова для возвращения кода ошибки. Какие-либо еще уведомления от функции обратного вызова о событии выполнения ГИП от ПФБ по той же функции не ожидаются.

8.1.4 BioSFPI_GUI_PROGRESS_EVENT_HANDLER

Функция обратного вызова

typedef вiоАРI_RETURN (BioAPl

* В i о S F РI_GUI_PROGRES S_EVENT_HANDLER)

BioAPI_UNIT_ID UnitID,

const void *GUIProgressEventHandlerCtx, const ВiоAPI_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, то ПФБ должен прекратить текущий процесс сбора биометрических данных и возвратить код ошибки.

Параметры

UnitID (входной) — ИД модуля биометрического датчика ПБУ, с которым связано событие ГИП.

GUIProgressEventHandlerCtx (входной) - контекст адреса, изначально предоставляемый приложением-подписчиком, как составная часть подписки на события ГИП.

Bitmaps (входной) - массив битов, содержащих изображение(я) образцов, запись которых произведена посредством выполнения процесса сбора биометрических данных, и которые предназначены для представления субъекту или оператору. Указанный массив, как правило, содержит ноль либо один битовый массив, но в случае, если ПФБ поддерживает мультимодальный сбор биометрических данных в ходе единичной операции сбора данных, такой массив может содержать множество битовых массивов.

Response (входной) — значение, указывающее на ответ ПБУ на уведомление о событии выбора ГИП (8.1.3).

6