dvpp_get_image_info

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

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

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

C函数原型

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

python函数

        
             img_info, ret = acl.himpi.dvpp_get_image_info(img_type, stream)

参数名	说明
img_type	int，要解析的码流类型。当前仅支持码流类型为HI_PT_JPEG，具体请参见hi_payload_type。
stream	dict，输入码流信息的指针地址。具体请参考hi_vdec_stream。 Atlas 推理系列产品，标准形态下，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。 Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。 Atlas 200I/500 A2 推理产品，EP模式下，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。 Atlas 200I/500 A2 推理产品，RC模式下，在Device上调用本接口时，该结构体内的addr参数配置的地址必须是Device上的内存地址。 Atlas A3 训练系列产品 / Atlas A3 推理系列产品，在Host上调用本接口时，该结构体内的addr参数配置的地址必须是Host上的内存地址。

参数名

说明

img_type

int，要解析的码流类型。当前仅支持码流类型为HI_PT_JPEG，具体请参见hi_payload_type。

stream

dict，输入码流信息的指针地址。具体请参考hi_vdec_stream。

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

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

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

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

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

返回值	说明
img_info	dict，图片信息字典，包含图片宽、高、宽Stride、高Stride、解码后占用的内存大小、源图片格式等信息。其中，源图格式通过“pixel_format”参数返回，具体请参见hi_img_info。
ret	int，错误码。返回0，表示成功。返回非0，表示失败。参见公共返回码。

返回值

说明

img_info

dict，图片信息字典，包含图片宽、高、宽Stride、高Stride、解码后占用的内存大小、源图片格式等信息。其中，源图格式通过“pixel_format”参数返回，具体请参见hi_img_info。

ret

int，错误码。

父主题： 公共接口