xtos_ bci_ session_ destroy
停止仍在 streaming 的会话,解除映射、关闭 fd 并释放会话。
本页目录
声明
#include <xtos/bci.h>
void xtos_bci_session_destroy(xtos_bci_session_t *session);参数
| 参数 | 类型 | 说明 |
|---|---|---|
| session | xtos_bci_session_t * | 会话句柄;NULL 时为空操作。 |
返回值
无返回值;停止、munmap 或 close 失败无法报告。
错误
没有 errno 错误返回。输入限制见注意事项。
注意事项
- 调用方必须先停止使用 fd、映射和其他会话接口;destroy 后所有借用资源失效。
- 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。
- 即使 STOP 失败或设备断开,也会尝试 legacy 和 frame 两类快照 release,再关闭 fd、释放两份 frame 缓冲和会话。清理错误无法返回;需要重试清理时应在 destroy 前显式 release。
示例
源码
本文按 OpenXTOS v1.0.2(c24e923717670c4724cdaf24c7c105caee8dc2fb)的头文件和实现编写。