CBXS3D SDK · 错误码 - 凯视佳产品文档

所有导出函数均返回 int 错误码，0（CBXS_RET_SUCCESS）表示成功，负数为错误。

常量	值	说明	排查方向
`CBXS_RET_SUCCESS`	0	函数返回成功	—
`CBXS_RET_PARAMERROR`	-1	输入参数错误	核对参数范围 / 句柄是否有效
`CBXS_RET_MALLOCFAIL`	-2	内存分配错误	系统内存不足
`CBXS_RET_NOTSUPPORT`	-3	该功能不支持	确认设备型号是否支持
`CBXS_RET_DEVICENOTEXIST`	-4	相机不存在	检查连接、网段与设备是否已打开
`CBXS_RET_DEVICENOTINIT`	-5	相机没有初始化	先 `CBXS_Initial` 并 `CBXS_OpenDevice`
`CBXS_RET_VIOLATION`	-6	操作冲突	如采集进行中修改了不可改参数，需先停止采集
`CBXS_RET_NOPRIVILEGE`	-7	权限错误	以管理员权限运行，或设备被其他进程占用
`CBXS_RET_FAIL`	-8	失败（普通失败，原因未知）	开启 `CBXS_SetLog` 查看日志
`CBXS_RET_WRONG`	-9	失败（普通失败，原因未知）	开启 `CBXS_SetLog` 查看日志
`CBXS_RET_RECOVERY_SUCCESS`	-10	相机恢复成功	—
`CBXS_RET_RECOVERY_FAIL`	-11	相机恢复失败	检查供电、线缆与连接
`CBXS_RET_BADFRAME`	-12	帧错误	检查触发与线缆质量
`CBXS_RET_INVALIDFRAME`	-13	无效帧	检查触发配置与曝光
`CBXS_RET_ZEROFRAME`	-14	帧存相机会返回此值：采集图像数据 0 字节，错误的帧	检查光条阈值 / 曝光是否过低
`CBXS_RET_VERSION_ERROR`	-15	版本错误	SDK 与固件 / 驱动版本不匹配
`CBXS_RET_TIMEOUT`	-16	设置读取超时后不恢复时，采集函数返回此值（而非恢复状态）	加大超时时间或检查触发信号
`CBXS_RET_DEVICECLOSED`	-17	相机已经关闭	重新打开设备
`CBXS_RET_BUSNOTINIT`	-18	总线没有初始化	检查驱动与 `CBXS_Initial` 调用
`CBXS_RET_CAM_NOT_CREATED`	-19	相机无法创建，通常因缺少对应类型的相机库文件	确认 SDK 库文件与位数（32/64）匹配

通用排查顺序

参数与采集状态：采集启动后 ROI / 触发模式 / 数据格式不可改（→ VIOLATION）；设置前先确认取值范围（→ PARAMERROR）。
设备状态：是否已 Initial / OpenDevice；是否被其他进程占用（→ DEVICENOTINIT / NOPRIVILEGE）。
连接与供电：设备是否在线、线缆是否正常（→ DEVICENOTEXIST / RECOVERY_FAIL）。
开启日志：CBXS_SetLog(true) 后复现，日志默认落在程序目录 ApiLogs/。

通用排查顺序

这份文档对您有帮助吗？