ГОСТ Р ИСО/МЭК 19784-2—2010
5.2.4 BioAFPI_UnitDetach
BioAPI_RETURN BioAPI BioAFPI_UnitDetach
(BioAPI_UNIT_ID UnitID).
Описание
Данная функция завершает сеанс соединения.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметраданной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызовефункции BioSPI_BSPAttach (в случае его наличия), могут не совпадать, еслиоба значения иден
тификатора соответствуютодному итому же модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID(входнойпараметр) — значение идентификатора модуля БиоАПИ. определенноев резуль
тате предварительного вызова функции BioAFPI_Queryllnits. Значение идентификатора UnitID было
внесено в поле Unitld каждогоэлемента BioAPI_UNIT_SCHEMA_ARRAY ПБФА.
Возвращаемое значение
ЗначениеBioAPI_RETURN указываетнауспешное выполнениефункцииили определяеттип ошиб
ки. Значение BioAPI_OK соответствует успешному выполнению функции. Остальные значения опреде
ляют типошибки.
Ошибки
BioAPIERRJNVALIDJJNITJD
5.2.5 BioAFPI_QueryUnits
BioAPI_RETURN BioAPI BioAFPI_QueryUnits
(const BioAPI_UUID ’BafpUuid.
BioAPI_UNIT_SCHEMA**UnitSchemaArray,
uint32_t ’NumberOfElements).
Описание
Данная функция возвращает массив схем модулейБиоАПИ(см. подраздел 7.55
ИСО/МЭК 19784-1—2006). управляемых данным ПБФА и находящихся в настоящий момент в подклю
ченном состоянии.
П р и м е ч а н и е — Когда ПБУ вызывает функцию ПБФ
BloAFPI_QueryUnlls,
ПБФ выделяет память для
данных, которые должны быть возвращены ПБУ. В некоторых архитектурах реализации ПБУ передает инфраструк
туре БиоАПИ данные и адреса в том виде, в котором они были возвращены ПБФ. поскольку инфраструктура
БиоАПИ интерпретирует эти адреса также, каких интерпретирует ПБФ. и поэтому может получитьдоступ кданным,
которые размещены по этим адресам. В других архитектурах реализации ПБУ необходимо переместить все дан
ные. возвращенные ПБФ. во вновь выделенные блоки памяти, ккоторым имеет доступ инфраструктура БиоАПИ. и
вызвать функцию
BloAFPI_Free
после копирования каждого блока памяти, но до возврата из вызова функции
BloSPt_QueryUnlts.
В первом случае, когда инфраструктура БиоАПИ вызывает функцию
BloSPI_Free.
ПБУ осу
ществляет соответствующий вызов функции
BioAFPI_Free.
Во втором случае вызов функции
BtoSPI_Free
будет
осуществляться непосредственно ПБУ. Тем не менее подобные различия вповедении ПБУ не отражаются в инфра
структуре БиоАПИ.
Блок памяти, содержащий массив, должен быть освобожден ПБУ посредством вызова функции
BioAFPI_Free. если он больше не используется ПБУ. Блок памяти, на который указывают элементы
UnitProperty в пределах каждого элемента массива, также должен быть освобожден приложением
посредством вызова функции BioAFPI_Free,еслион больше не используется ПБУ.
Даннаяфункция можетбытьвызванатолькопосле вызова функции BioAFPI_Loadpnpопределен
ного ПБУ ине может быть вызвана после вызова функции BioAFPI_Unloadдляданного ПБУ.
Значение идентификатора модуля, возвращаемоеданнойфункциейдляданного модуля БиоАПИ,
может не совпадать со значением идентификатора модуля, возвращаемым ПБУ инфраструктуре
БиоАПИ. ПБУ может преобразовать любое значение идентификатора модуля (полученное от ПБФ) в
другое значение идентификатора модуля передпередачей егоинфраструктуре БиоАПИ. Даннов преоб
разование может выполняться во избежание существования повторяющихся идентификаторов моду
лей в пределах ПБУ. что может иметь место в случае использования ПБУ двух или более ПБФ одной и
той же категории или в случае одновременного использования ПБУ ПБФА и непосредственного
управления модулями архива.
Параметры
BafpUuid (входной параметр) — уникальный идентификатор ПБФА. для которого должны быть
возвращены данные.
6