hi_mpi_vdec_get_jpegd_output_info

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	x
Atlas 200/300/500 推理产品	x

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

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

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)

参数名	输入/输出	说明
stream	输入	输入码流信息的指针。对于以下产品，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址： Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件 Atlas 200I/500 A2 推理产品的Ascend EP形态 Atlas 推理系列产品的Ascend EP形态对于以下产品，在Device上调用本接口时，该结构体内的addr参数配置的地址必须是Device上的内存地址： Atlas 200I/500 A2 推理产品的Ascend RC形态
output_format	输入	输出图片格式。若按源图格式获取相关信息，则将该参数值设置为HI_PIXEL_FORMAT_UNKNOWN；若按指定格式获取相关信息，则将该参数值设置为对应的图片格式，支持的图片格式请参见图片格式、宽高对齐、内存约束。
img_info	输出	输出图片信息结构体，包含图片宽、高、宽stride、高stride、解码后占用的内存大小、图片格式等信息。其中，输出图片格式，通过img_pixel_format参数返回。

参数名

输入/输出

说明

stream

输入

输入码流信息的指针。

对于以下产品，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址：

对于以下产品，在Device上调用本接口时，该结构体内的addr参数配置的地址必须是Device上的内存地址：

output_format

输入

输出图片格式。

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

img_info

输出

输出图片信息结构体，包含图片宽、高、宽stride、高stride、解码后占用的内存大小、图片格式等信息。

其中，输出图片格式，通过img_pixel_format参数返回。

父主题： VDEC视频解码功能/JPEGD图片解码功能