ГОСТ Р ИСО/МЭК 19784-4— 2014
8.2.6 Ф ункция BioSFPI_ControlUnit
BioAPI_RETURN BioAPI BioSFPI_Contro1Unit
(BioAPI_UNIT_ID ‘JnitlD,
uinr32_t ControlCode,
const BioAPI. DATA ’InputData,
BioAPI_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 указывает на успешное выполнение функции или определяет тип
ошибки. Значение ВюАР1_ОК указывает на отсутствие ошибки и успешное выполнение функции. Все
остальные значения описывают тип ошибки.
Ошибки
ВiОАР1ЕRR_MEMORY_ERROR
BioAPIERR.INVAL1D_P0INTER
BioAPIERR_FUNCT10N_FAILED
BioAPIERR.FUNCTION_»JOT_SUPPORTED
8.2.7 Ф ункция BioSFPI_Cancel
BioAPI_RETURN BioAPI BioSFPl_Cancel
(BioAPl_UNIT_lD UnitID);
Описание
Данная функция отменяет вызов, который находится в заблокированном состоянии, к модулю
BioAPI. Функция не должна возвращаться до тех пор, пока заблокированный вызов не будет отменен.
Выполнение ПФД должно допускать, что данная функция может быть вызвана из ПБУ в любой
момент. Заблокированный вызов к модулю BioAPI не должен препятствовать вызову данной функции.
Не существует каких-либо требований, чтобы значение ИД модуля, предоставляемого ПБУ в ка
честве входного к данной функции, совпадало со значением ИД модуля, который структура предостав
ляет ПБУ в исходном вызове к BioSPI_BSPAttach при условии, что два значения ИД модуля определяют
один и тот же модуль BioAPI (8.2.4).
10