libxtos-bcixtos_bci_session_destroy

xtos_bci_session_destroy

停止仍在 streaming 的会话,解除映射、关闭 fd 并释放会话。

本页目录

声明

c
#include <xtos/bci.h>

void xtos_bci_session_destroy(xtos_bci_session_t *session);

参数

参数类型说明
sessionxtos_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)的头文件和实现编写。