xtos_ bci_ frame_ snapshot_ release
先本地 unmap,再释放 token;无本家族快照时成功返回 0。
本页目录
声明
#include <xtos/bci.h>
int xtos_bci_frame_snapshot_release(xtos_bci_session_t *session);参数
| 参数 | 类型 | 说明 |
|---|---|---|
| session | xtos_bci_session_t * | 非 NULL,调用方持有且负责生命周期;必须串行使用。 |
返回值
成功返回 0;失败返回 -1 并保留原 errno。必须根据剩余所有权重试;释放不会消费 ring。
错误
| errno | 条件 |
|---|---|
| EINVAL | session 为 NULL。 |
| munmap errno | 解除映射失败;映射和 token 均保留,允许重试。 |
| ioctl errno | 本地映射已解除,token 清理按本家族规则处理。 |
注意事项
- 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。
- 任何 ioctl 失败均保留 token 供重试,包括 ENODEV/ENOENT/ESTALE;解除映射后 consume 返回 ENOENT,acquire/read 仍 EBUSY,直至 release 成功或 destroy。
- 断连后也允许尝试释放;成功 unmap 后所有输出指针立即失效,SDK 不会回写清空调用方旧描述符。munmap 失败时尚未发释放 ioctl。
- destroy 即使 STOP 失败也尝试两个家族的清理,但 destroy 无返回值,不能保证或重试其失败;需要可观察清理结果时先显式 release 并处理失败。
示例
#include <xtos/bci.h>
int release_view(xtos_bci_session_t *s) {
return xtos_bci_frame_snapshot_release(s);
}源码
本文按 OpenXTOS v1.0.2(c24e923717670c4724cdaf24c7c105caee8dc2fb)的头文件和实现编写。