acl.himpi.vdec_get_frame

hi_s32 hi_mpi_vdec_get_frame(hi_vdec_chn chn, hi_video_frame_info *frame_info, hi_vdec_supplement_info *supplement, hi_vdec_stream *stream, hi_s32 milli_sec);

frame_info, supplement, stream, ret = acl.himpi.vdec_get_frame(chn, milli_sec)

获取视频解码通道的解码图像及输入Stream。

chn：解码通道号。

在昇腾310 AI处理器上，该参数的取值范围：[0, 32)。

在昇腾910 AI处理器上，该参数的取值范围：[0, 32)。

ret：

• 0：获取数据成功，但有可能是解码失败的数据，解码成功或失败，需要查看hi_video_frame字典（hi_video_frame_info字典的成员）中的frame_flag参数。
• 非0：失败，参见VDEC视频/JPEGD图像解码返回码

stream：获取已完成解码的输入码流信息指针。

frame_info：获取已经完成解码的图像信息。解码后的数据存放在Device内存中。

supplement：获取的解码图像补充信息。预留参数，暂未使用，建议用户设置为NULL。

• 向VDEC获取解码结果，输入buffer和输出buffer一起获取。
• JPEGD图片解码时，对于420、422、440格式的输入图片，如果输入图片的宽高为奇数，JPEGD解码输出图片的宽高为向下2对齐；对于444、400格式的输入图片，JPEGD解码输出图片的宽高与输入图片保持一致。

• 此接口通过改变milli_sec值支持阻塞方式、非阻塞方式、超时方式获取解码图像。
• 获取解码图像时必须保证通道已经被创建，否则直接返回通道未创建的错误码HI_ERR_VDEC_UNEXIST。如果在获取图像的过程中销毁通道，就会立刻返回错误码 HI_ERR_VDEC_UNEXIST。
• 如果在获取解码图像的过程中复位通道，则会返回错误码HI_ERR_VDEC_UNEXIST。
• 以非阻塞方式获取解码图像，如果缓冲区内无图像，会立刻返回错误码HI_ERR_VDEC_BUF_EMPTY。
• 以超时方式获取解码图像，到达设定的超时时间还不能获取到图像则会返回错误码 HI_ERR_VDEC_BUF_EMPTY。

解码后，获取解码通道的解码图像及输入Stream。