xtos_
复制会话创建时缓存的设备信息到调用方结构。
本页目录
声明
#include <xtos/bci.h>
int xtos_bci_get_info(xtos_bci_session_t *session,
struct xtos_bci_device_info *info);参数
| 参数 | 类型 | 说明 |
|---|---|---|
| session | xtos_bci_session_t * | 非 NULL 会话句柄。 |
| info | struct xtos_bci_device_info * | 非 NULL 输出结构，由调用方提供。 |
输出字段
| 字段 | 类型 | 含义 |
|---|---|---|
| name | char[32] | 设备名称字符数组；不保证 NUL 结尾，显示时需限制长度。 |
| dev_id | uint32_t | 设备标识编号，无单位。 |
| num_channels | uint32_t | 设备通道数量，单位为通道。 |
| sampling_rate | uint32_t | 当前采样率，单位 Hz。 |
| resolution_bits | uint32_t | ADC 分辨率，单位 bit。 |
| input_range_mv | uint32_t | 输入范围，单位 mV；公开 UAPI 使用整数。 |
| interface | uint32_t | 表示设备接口类型枚举值；具体取值由 UAPI 定义，无单位。 |
返回值
成功返回 0 并复制结构；失败返回 -1。不会重新发送 GET_INFO ioctl。
错误
| errno | 条件 |
|---|---|
| EINVAL | session 或 info 为 NULL。 |
注意事项
- info.name 是固定 32 字节数组，不能假设一定有 NUL 结尾；显示时应使用长度限制。
- 输出由调用方拥有；缓存可能是 GET_INFO 失败后的零值。
示例
源码
本文按 OpenXTOS 提交 dd313955ad57542bcd2af8827157d1bbd0cf5e83 的头文件和实现编写。