hi_mpi_vi_get_chn_frame

产品支持情况

功能说明

从指定VI通道获取的视频图像信息，图像信息主要包括：图像的宽度、高度、像素格式、时间戳以及YUV各分量的地址等等。

函数原型

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)

参数说明

返回值说明

• 0：成功
• 非0：失败，参见VI视频输入返回码。

约束说明

• 调用本接口前，必须先调用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获取图像。

参考资源

接口调用流程，参见视频数据获取功能。