acl.himpi.vdec_get_jpegd_output_info

hi_s32 hi_mpi_vdec_get_jpegd_output_info(const hi_vdec_stream *stream, const hi_pixel_format output_format, hi_img_info *img_info)

img_info, ret = acl.himpi.vdec_get_jpegd_output_info(stream, output_format)

图片解码场景下，根据输入码流，获取按源图格式或指定图片格式输出时的图片宽、高、宽stride、高stride、解码后占用的内存大小、图片格式等信息。

该接口会检查图片格式是否支持解码，如果遇到不支持的码流则该接口会返回HI_ERR_VDEC_NOT_SUPPORT错误码，该错误码的详细描述请参见公共返回码。

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

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

• stream：dict，输入码流信息字典。具体参见hi_vdec_stream。

  Atlas 推理系列产品（Ascend 310P处理器），标准形态下，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。

  Atlas A2训练系列产品/Atlas 300I A2推理产品，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。

  Atlas 200/500 A2推理产品，EP模式下，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。

  Atlas 200/500 A2推理产品，RC模式下，在Device上调用本接口时，该结构体内的addr参数配置的地址必须是Device上的内存地址。

• output_format：int，输出图片格式。

  若按源图格式获取相关信息，则将该参数值设置为HI_PIXEL_FORMAT_UNKNOWN = 0。若按指定格式获取相关信息，则将该参数值设置为对应的图片格式，支持的图片格式请参见图片格式、宽高对齐、内存约束。

• img_info：dict，输出图片信息字典，包含图片宽、高、宽stride、高stride、解码后占用的内存大小、图片格式等信息。其中，输出图片格式，通过pixel_format参数返回。具体参见hi_img_info。
• ret：int，错误码。
  • 0：成功。
  • 非0：失败，参见VDEC视频/JPEGD图像解码返回码。