xtos_
通过 ioctl 请求设备使用指定整数采样率，并在成功后更新会话缓存。
本页目录
声明
#include <xtos/bci.h>
int xtos_bci_set_sampling_rate(xtos_bci_session_t *session, uint32_t rate);参数
| 参数 | 类型 | 说明 |
|---|---|---|
| session | xtos_bci_session_t * | 非 NULL 会话句柄。 |
| rate | uint32_t | 采样率，单位 Hz；库本身不检查设备支持列表。 |
返回值
ioctl 成功返回 0 并更新 info.sampling_rate；失败返回 -1且不更新缓存。
错误
| errno | 条件 |
|---|---|
| EINVAL | session 为 NULL，或驱动认为 rate 无效。 |
| ENOTTY/EOPNOTSUPP | 设备不支持设置采样率。 |
| system errno | ioctl 失败时返回驱动或系统 errno。 |
注意事项
- 库不重新分配已有 ring buffer，也不验证硬件是否实际采用应用期望配置。
- 成功只更新用户态缓存；与读取、mmap 或其他配置并发调用不安全。
示例
源码
本文按 OpenXTOS 提交 dd313955ad57542bcd2af8827157d1bbd0cf5e83 的头文件和实现编写。