hi_mpi_dvpp_get_image_info

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	x

功能说明

根据输入码流，获取按源图格式输出时的图片宽、高、宽stride、高stride、解码后占用的内存大小、源图片格式等信息。该接口会检查图片格式是否支持解码，如果遇到不支持的码流则该接口会返回HI_ERR_VDEC_NOT_SUPPORT错误码，该错误码的详细描述请参见VDEC视频解码/JPEGD图片解码返回码。

函数原型

hi_s32 hi_mpi_dvpp_get_image_info(hi_payload_type img_type, const hi_vdec_stream *stream, hi_img_info *img_info);

参数说明

参数名	输入/输出	说明
img_type	输入	要解析的码流类型。当前仅支持码流类型为HI_PT_JPEG。
stream	输入	输入码流信息的指针。 Atlas 推理系列产品，Ascend EP形态下，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。 Atlas 200I/500 A2 推理产品，Ascend EP形态下，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。 Atlas 200I/500 A2 推理产品，Ascend RC形态下，在Device上调用本接口时，该结构体内的addr参数配置的地址必须是Device上的内存地址。 Atlas A2 训练系列产品/Atlas A2 推理系列产品，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。 Atlas A3 训练系列产品/Atlas A3 推理系列产品，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。
img_info	输出	图片信息的指针，包含图片宽、高、宽stride、高stride、解码后占用的内存大小、源图片格式等信息。其中，源图格式通过pixel_format参数返回。

参数名

输入/输出

说明

img_type

输入

要解析的码流类型。

当前仅支持码流类型为HI_PT_JPEG。

stream

输入

输入码流信息的指针。

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

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

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

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

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

img_info

输出

图片信息的指针，包含图片宽、高、宽stride、高stride、解码后占用的内存大小、源图片格式等信息。

其中，源图格式通过pixel_format参数返回。

返回值说明

0：成功
非0：失败，参见VDEC视频解码/JPEGD图片解码返回码。

父主题： 公共接口