hi_mpi_vdec_get_frame
Atlas 200/300/500 推理产品,不支持该接口。
Atlas 训练系列产品,不支持该接口。
函数功能
解码后,获取解码通道的解码图像及输入Stream。
JPEGD图像解码场景下,在调用本接口时,如果硬件解码失败,则会在本接口内部触发软件解码。
约束说明
- 向VDEC获取解码结果,输入buffer和输出buffer一起获取。
- JPEGD图片解码时,默认对于jpeg(420)、jpeg(422)、jpeg(440)格式的输入图片,如果输入图片的宽高为奇数,JPEGD解码输出图片的宽高为向下2对齐;默认对于jpeg(444)、jpeg(400)格式的输入图片,JPEGD解码输出图片的宽高与输入图片保持一致。若需调整输出图片的宽、高对齐模式,可调用hi_mpi_vdec_set_jpegd_precision_mode接口。
函数原型
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)
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
chn |
输入 |
解码通道号。 Atlas 推理系列产品(Ascend 310P处理器),该参数的取值范围:[0, 256),JPEGD功能和VDEC功能共用通道,且通道总数最多256。 Atlas A2训练系列产品/Atlas 800I A2推理产品,该参数的取值范围:[0, 256),JPEGD功能和VDEC功能共用通道,且通道总数最多256,其中,JPEGD解码通道总数最多256,VDEC解码通道总数最多32。 Atlas 200/500 A2推理产品,该参数的取值范围:[0, 128),JPEGD功能和VDEC功能共用通道,且通道总数最多128。 |
frame_info |
输出 |
已解码的图像信息的指针。解码后的数据存放在Device内存中。 |
supplement |
输出 |
解码图像补充信息的指针。预留参数,暂未使用,建议用户设置为NULL。 |
stream |
输出 |
已解码的输入码流信息指针。 |
milli_sec |
输入+ |
超时时间,单位是毫秒。
说明:
JPEGD图像解码场景下,此处配置的超时时间仅指获取硬件解码结果的等待时间,不包含软件解码的时间。 |
返回值说明
- 0:成功,获取解码数据成功后,需调用hi_mpi_vdec_release_frame接口释放解码相关资源。
本接口虽返回成功,但有可能获取到的是解码失败的数据,解码是否成功,需要查看hi_video_frame_info结构体的v_frame成员下的frame_flag参数值说明。
- 非0:失败,参见VDEC视频解码/JPEGD图片解码返回码
注意:
- 如果在解码图像时未创建通道,则会返回错误码HI_ERR_VDEC_UNEXIST。
- 如果在获取图像的过程中销毁通道,则会返回错误码HI_ERR_VDEC_UNEXIST。
- 如果在获取解码图像的过程中复位通道,则会返回错误码HI_ERR_VDEC_UNEXIST。
- 以非阻塞方式获取解码图像,如果缓冲区内无图像,则会返回错误码HI_ERR_VDEC_BUF_EMPTY。
- 以超时方式获取解码图像,到达设定的超时时间还不能获取到硬件解码结果则会返回错误码HI_ERR_VDEC_BUF_EMPTY,此时则可增大超时时间,或循环调用本接口等待解码结果。