ГОСТ Р ИСО/МЭК 19784-4—2014
Описание
Данная функция возвращает массив схем модулей BioAPI (см. 7.55 в ИСО/МЭК 19784-1:2006),
которые управляются заданным ПФБД и находятся в состоянии ввода.
П р и м е ч а н и е — Когда ПБУ вызывает функцию ПФБ BioSFPI_QueryUnits. ПФБ выделяет память для
данных, которые будут возвращены ПБУ В некоторых схемах выполнения ПБУ передает данные приложению в
точности, как возвращено ПФБ. так как приложение интерпретирует адрес так же. как и ПФБ, и сможет получить
доступ к данным, которые размещены по данному адресу. В других схемах выполнения ПБУ будет необходимо
переместить все данные, возвращенные ПФБ. во вновь выделенный блок памяти, доступный приложению, и вы
звать функцию BioSPI_Free после копирования каждого блока памяти, но перед возвращением вызова функции
BioAPI_QueryUnits. В первом случае, когда инфраструктура вызывает функцию BioSPI_Free. ПБУ совершает со
ответствующий вызов функции BioSFPI_Free. В последнем случае вызовы функции BioSPI_Free будут внутренне
поддерживаться ПБУ. Тем не менее такие отличия в поведении ПБУ не заметны для инфраструктуры.
Когда блок памяти, содержащий массив, более не нужен ПБУ. посредством вызова функции fi/oS-
FPI_Froe ПБУ освобождает данный блок памяти. Блок памяти, на который указывает параметр Unit-
Property внутри каждого элемента массива, должен быть также освобожден ПБУ через вызов функции
BioSFPI_Free после того, как у ПБУ больше не будет в нем необходимости.
Данная функция должна вызываться только после того, как функция BioSFPI_Load была вызвана
для определенного ПФБ.
Не существует каких-либо требований, чтобы ИД модуля, который возвращается данной функци
ей для данного модуля BioAPI. был доступен по такому же значению ИД модуля от ПБУ к инфраструк
туре. ПБУ может перевести любое значение ИД модуля (предоставленное ПФБ) в другое значение ИД
перед тем. как предоставить его инфраструктуре. Цель такого перевода заключается в предотвраще
нии дублирования ИД модулей внутри области ПБУ. что может произойти, когда ПБУ использует два
или более ПФБ одинаковой категории либо, когда ПБУ использует ПФБД и одновременно напрямую
управляет биометрическими датчиками.
Параметры
BSFPUuid (входной) — уникальный идентификатор для ПФБД. информация о котором должна
быть возвращена:
UnitSchemaArray (входной) — указатель для адреса массива элементов типа BioAPI_UNIT_SCHE-
МА (местоположение которых определено ПБУ), содержит информацию о схеме модуля.
NumberOfESements (входной) — указатель числа элементов в массиве, который управляется дан
ным ПФБД и находится в состоянии ввода.
Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип
ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все
остальные значения описывают тип ошибки.
Ошибки
BioAPIERR_INVALID_UUID
BioAPIEP.R_MEMORY_ ERROR
8.2.5 Функция BioSFPI_Freo
BioAPI_RETURN BioAPI BioSFPI_Free
(void *Ptr);
Описание
Данная функция освобождает область памяти, на которую указывает параметр Ptr. Если параметр
Ptr имеет нулевое значение, то никакие действия не выполняются. Если параметр Ptr не соответствует
указателю, ранее возвращенному функциями BioSPFI, или если область памяти уже была
освобождена вызовом функции BioSFPI_Free, то последствия вызова данной функции неопределенны.
Параметры
Ptr (входной) — указатель на освобождаемую память.
Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип
ошибки. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции.
9