hi_mpi_vdec_set_display_mode

产品支持情况

功能说明

若调用hi_mpi_sys_bind接口绑定数据接收者VPSS与数据源VDEC后，可调用本接口设置显示模式。不设置显示模式时，默认为回放模式。

函数原型

hi_s32 hi_mpi_vdec_set_display_mode(hi_vdec_chn chn, hi_video_display_mode display_mode)

参数说明

返回值说明

• 0：成功
• 非0：失败，参见公共返回码、VDEC视频解码/JPEGD图片解码返回码

约束说明

• 设置显示模式前必须保证通道已创建，否则会返回通道未创建的错误码HI_ERR_VDEC_UNEXIT。
• 预览模式（HI_VIDEO_DISPLAY_MODE_PREVIEW）：预览模式下VDEC绑定的直接后级模块（比如VPSS）以非阻塞方式接收解码图像，即当VPSS的图像Buffer满时（解码帧存个数比VPSS缓存队列个数多）， VPSS丢弃VDEC发送过来的图像，以达到不反压VDEC解码的目的，实现实时预览。需要注意的是， 当解码帧存个数比VPSS缓存队列个数少时，即使开启预览模式， VPSS还是会反压解码。
• 回放模式（HI_VIDEO_DISPLAY_MODE_PLAYBACK）：回放模式下VDEC绑定的直接后级模块（比如VPSS）以阻塞方式接收解码图像， 即当VPSS的图像Buffer满时，拒绝接收VDEC发送过来的图像， VDEC发现当前图像发送失败后启动图像重新发送机制，直到图像发送成功为止。回放模式下VDEC绑定的直接后级模块能够反压VDEC解码，以达到不丢弃任何一帧解码图像的回放效果。