hi_mpi_vi_get_chn_frame
Atlas 200/300/500 推理产品,不支持该接口。
Atlas 训练系列产品,不支持该接口。
Atlas 推理系列产品(Ascend 310P处理器),不支持该接口。
Atlas A2训练系列产品/Atlas 800I A2推理产品,不支持该接口。
函数功能
从指定VI通道获取的视频图像信息,图像信息主要包括:图像的宽度、高度、像素格式、时间戳以及YUV各分量的地址等等。
约束说明
- 调用本接口前,必须先调用hi_mpi_vi_create_pipe接口创建PIPE。
- 通道已启用且通道队列深度不为0时,才能调用本接口获取到图像。
- 支持多次获取后再释放,但建议获取和释放接口配对使用。
- 获取的地址信息来自模块内部使用的临时内存,因此使用完之后,必须要调用hi_mpi_vi_release_chn_frame接口释放其内存。
- 用户可结合hi_mpi_vi_get_chn_fd接口,采用select/epoll方式等待可读图像信息,等到有可用的视频输入数据后再通过非阻塞方式使用hi_mpi_vi_get_chn_frame获取图像。
函数原型
hi_s32 hi_mpi_vi_get_chn_frame(hi_vi_pipe vi_pipe, hi_vi_chn vi_chn, hi_video_frame_info *frame_info, hi_s32 milli_sec)
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
vi_pipe |
输入 |
PIPE号。 取值范围:[0, 12)。 |
vi_chn |
输入 |
VI通道号。 取值范围:[0, 1) |
frame_info |
输入 |
VI帧信息结构体。 |
milli_sec |
输入 |
超时参数 。取值范围:
|
返回值说明
- 0:成功
- 非0:失败,参见VI视频输入返回码。
父主题: VI视频输入功能