hi_mpi_vpss_get_chn_frame

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	x
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	x
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	x
Atlas 训练系列产品	x
Atlas 200/300/500 推理产品	x

用户从通道获取一帧处理完成的图像。

hi_s32 hi_mpi_vpss_get_chn_frame(hi_vpss_grp grp, hi_vpss_chn chn, hi_video_frame_info *frame_info, hi_s32 milli_sec)

参数名	输入/输出	说明
grp	输入	VPSS组ID。取值范围：[0, 264)。如果通过hi_mpi_vpss_create_grp接口的hi_vpss_grp_attr.nr_en参数开启3DNR功能，则VPSS组ID的取值范围为：[256, 268)。
chn	输入	VPSS通道号。取值范围：[0, 2)
frame_info	输出	图像信息。
milli_sec	输入	超时时间。取值范围： -1：表示阻塞模式，程序一直等待，直到获取到图像才返回； 0：表示非阻塞模式； >0：配置具体的超时时间，单位为毫秒（ms）。在此指定时间内如果没有获取到图像，则超时返回。

只有在通过hi_mpi_vpss_get_chn_attr接口设置为USER模式下，并且队列深度不为0，才能获取到图像。
调用该接口获取图像，不会对后端绑定的模块有影响。如后端绑定VO显示，可以在显示过程中获取图像，VO仍正常显示，不会受到影响。
解码回放场景，由于不允许出现丢帧，VPSS只要有一个通道不处理新图像（通道已开启），则整个VPSS不处理新图像。例如开启了通道0和通道1，两者都不绑定后端，通道图像队列长度都设为2，此时从通道0中最多获取出2帧已缓存的图像，因为通道1缓存2帧后未处理新图像，所以VPSS不会再处理新图像。

父主题： VPSS视频处理功能