iofunc_close_ocb()

Освободить участок памяти, выделенный под блок открытого контекста (OCB, Open Control Block)

Прототип:

#include <sys/iofunc.h>
                                       
int iofunc_close_ocb( resmgr_context_t *ctp,
                      iofunc_ocb_t *ocb,
                      iofunc_attr_t *attr );

Аргументы:

ctp: Указатель на структуру resmgr_context_t, которую библиотека менеджера ресурсов использует для передачи контекстной информации между функциями.
ocb: Указатель на структуру блока управления открытым контекстом (OCB, Open Control Block) iofunc_ocb_t, созданную при открытии ресурса клиентом.
attr: Указатель на атрибутную запись iofunc_attr_t, описывающую характеристики устройства, связанного с менеджером ресурсов.

Описание:

Функция iofunc_close_ocb() отключает указанный OCB ocb и освобождает связанную с ним память.

Эта функция предполагает, что ocb указывает на структуру iofunc_ocb_t. Если структура iofunc_ocb_t инкапсулируется в пользовательской структуре OCB, то она должна быть первым полем пользовательского OCB, иначе вызывать функцию нельзя. Если указана функция ocb_free() в структуре iofunc_mount_t, то она будет вызвана. Это означает, что по крайней мере часть iofunc_ocb_t пользовательского OCB больше не действительна после iofunc_close_ocb().

iofunc_close_ocb() вызывает функцию iofunc_ocb_detach().

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

EOK: Успешное завершение.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока: Нет
Обработчик прерываний: Нет
Обработчик сигналов: Да
В потоке: Да

Тематические ссылки:

iofunc_attr_t, iofunc_close_dup(), iofunc_close_ocb_default(), iofunc_ocb_free(), iofunc_ocb_t, resmgr_context_t

Предыдущий раздел: Описание API системной библиотеки