hi_mpi_vdec_get_frame

函数功能

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

JPEGD图像解码场景下,在调用本接口时,如果硬件解码失败,则会在本接口内部触发软件解码。

Atlas 200/300/500 推理产品,不支持该接口。

Atlas 训练系列产品,不支持该接口。

约束说明

函数原型

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训练系列产品,该参数的取值范围:[0, 256),JPEGD功能和VDEC功能共用通道,且通道通道总数最多256,其中,JPEGD解码通道总数最多256,VDEC解码通道总数最多32。

frame_info

输出

已解码的图像信息的指针。解码后的数据存放在Device内存中。

supplement

输出

解码图像补充信息的指针。预留参数,暂未使用,建议用户设置为NULL。

stream

输出

已解码的输入码流信息指针。

milli_sec

输入

超时时间,单位是毫秒。
  • -1:阻塞方式
  • 0:非阻塞方式
  • >0:超时方式,配置具体的超时时间。超时时间受操作系统影响,一般偏差在操作系统的一个时间片内,例如,操作系统的一个时间片为4ms,用户设置的milli_sec参数值为1,则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下,超时时间仍可能存在波动。
说明:

JPEGD图像解码场景下,此处配置的超时时间仅指获取硬件解码结果的等待时间,不包含软件解码的时间。

返回值说明

参考资源

接口调用流程及示例,参见JPEGD图片解码VDEC视频解码