ГОСТ Р ИСО/МЭК 19784-2—2010
UnitSchemaArray (выходной параметр) — указатель на адрес массива элементов типа
BioAPI_UNIT_SCHEMА (размещенного ПБУ, см. также примечание кописаниюданной функции), содер
жащего информацию о схеме модуля БиоАПИ.
NumborOfElements (выходной параметр) — указатель на количество элементов массива, кото
рые управляютсяданным ПБФА ив настоящий момент находятся в подключенном состоянии.
Возвращаемое значение
ЗначениеBioAPI_RETURN указываетнауспешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствуетуспешному выполнению функции. Остальныезначения опреде
ляюттип ошибки.
Ошибки
BioAPIERRJNVALIDJJUID
BioAPIERR_MEMORY_ERROR
5.2.6 BioAFPI_Free
BioAPI_RETURN BioAPI BioAFPI_Free
(void *Ptr).
Описание
Данная функция очищает область памяти, на которую указывает параметр Ptr. Если Pfr имеет
NULL-значение, никакиедействия не выполняются. Если Ptrне соответствует указателю, ранее возвра
щенному одной из функций BioAFPI. или область памяти ранее уже была очищена с помощью вызова
функции BioAFPI_Free, последствия вызоваданной функции неопределены.
Параметры
Ptr (входной параметр) — указательна очищаемую область памяти.
Возвращаемое значение
ЗначениеBioAPI_RETURN указываетнауспешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствует успешному выполнению функции. Остальные значения опреде
ляюттип ошибки.
Ошибки
5.2.7 BioAFPI_ControlUnlt
BioAPI_RETURN BioAPI BioAFPI_ControlUnit
(BioAPI_UNIT_ID UnitID,
uint32_t ControlCode.
const BioAPI_DATA ’InputData.
BioAPI_DATA ’OutputData).
Описание
Данная функцияотправляетуправляющиеданные модулю БиоАПИ и получаетот модуля БиоАПИ
данные о состоянии или функционировании. Содержаниеэлемента ControlCode, а такжеотправляемые
данные (входной параметр для функции BioAFPI_ControlUnit) и получаемые данные (выходной пара
метрдля функции BioAFPI_ControlUnit) будут подробно рассмотрены вспецификации интерфейса, свя
занного с данным модулем БиоАПИ.
Данная функция выделяетобластьпамяти, достаточнуюдля размещения выходныхданных, кото
рые должны быть возвращены приложению, заполняет выделенную область данными и записывает в
поля Length и Data структуры OutputData размер иадрес области памяти.
Область памяти, возвращенная в результате вызоваодной изфункций ИПБФА. будетосвобожде
на приложением с помощью вызова функции BioAFPI_Free.
Данная функция является открытым каналом к модулю БиоАПИ и может быть использована для
любых целей, которые не могут быть достигнуты стандартизированными функциями (например, веде
ние архива, восстановление индекса и прочее).
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (вслучаеего наличия), могут не совпадать, еслиоба значения иден
тификатора соответствуютодному и томуже модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входной параметр) — значение идентификатора модуля БиоАПИ. определенное в
результате предварительного вызова функции BioAFPI.
ControlCode (входнойпараметр) — код вызываемой функции в модуле БиоАПИ.
7