凯视佳产品文档 产品文档与技术支持

CB_Device SDK · 采集控制

版本 1.0 · 更新于 2026-10-21 · 阅读 0

采集缓冲数量、采集超时、开始/停止采集与采集状态查询。

CB_GetGrabBufferNum

CB_RESULT CB_GetGrabBufferNum(int32_t iDevIndex, uint32_t *puiBufferNum)

获取采集缓存Buffer数目。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]
puiBufferNum out 当前的采集缓存Buffer个数

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）

CB_SetGrabBufferNum

CB_RESULT CB_SetGrabBufferNum(int32_t iDevIndex, uint32_t uiBufferNum)

设置采集缓存Buffer数目。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]
uiBufferNum in 设置SDK采集缓存Buffer个数。根据帧大小及内存自行决定，默认16。

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）

CB_GetGrabTimeout

CB_RESULT CB_GetGrabTimeout(int32_t iDevIndex, uint32_t *puiTimeoutMs)

获取采集超时时间。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]
puiTimeoutMs out 返回当前采集超时时间（毫秒）

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）

CB_SetGrabTimeout

CB_RESULT CB_SetGrabTimeout(int32_t iDevIndex, uint32_t uiTimeoutMs)

设置采集超时时间。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]
uiTimeoutMs in 采集超时时间，单位ms。0xffffffff表示无限等待

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）

说明

  • @note 设置的超时时间要保证大于一帧正常采集的时间，否则正常的采集也会出现超时错误。

CB_StartGrabbing

CB_RESULT CB_StartGrabbing(int32_t iDevIndex)

启动采集。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）

说明

  • @note 这个函数内部会向设备发送“AcquisitionStart”命令，用户不必发送。

CB_StopGrabbing

CB_RESULT CB_StopGrabbing(int32_t iDevIndex)

停止采集。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）

说明

  • @note 这个函数内部会向设备发送“AcquisitionStop”命令，用户不必发送。

CB_IsGrabbing

CB_RESULT CB_IsGrabbing(int32_t iDevIndex, _Bool *pbGrabbing)

设备是否处于采集状态。

参数 方向 说明
iDevIndex in 设备索引，取值范围[0,(CB_EnumerateDevices()-1)]
pbGrabbing out 获取设备是否正在采集

返回：成功返回 CB_E_SUCCESS；失败返回错误码（见错误码章节）