libxtos-bcixtos_bci_get_mmap_buffer

xtos_bci_get_mmap_buffer

固定 v1.0.2 拒绝不安全的无版本 mmap;改用版本化快照。

本页目录

声明

c
#include <xtos/bci.h>

void *xtos_bci_get_mmap_buffer(xtos_bci_session_t *session, size_t *size);

参数

参数类型说明
sessionxtos_bci_session_t *有效会话返回 EOPNOTSUPP;NULL 返回 EINVAL。
sizesize_t *可为 NULL;非 NULL 时在检查会话前始终写 0,单位字节。

返回值

始终返回 NULL;有效 session 设置 errno=EOPNOTSUPP,NULL session 设置 EINVAL;非 NULL size 始终为 0。

错误

errno条件
EOPNOTSUPP有效会话也拒绝旧 mmap。
EINVALsession 为 NULL,仍先清零 size。

注意事项

  • size=0;有效会话 EOPNOTSUPP;不估算容量、不调用 mmap、不建立或借出映射。
  • 使用 xtos_bci_snapshot_acquire 或 xtos_bci_frame_snapshot_acquire,并显式 consume/release;调用方不得自行映射借用 fd。
  • 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。

示例

源码

本文按 OpenXTOS v1.0.2(c24e923717670c4724cdaf24c7c105caee8dc2fb)的头文件和实现编写。