hi_mpi_vdec_get_jpegd_output_info
函数功能
图片解码场景下,根据输入码流,获取按源图格式或指定图片格式输出时的图片宽、高、宽stride、高stride、解码后占用的内存大小、图片格式等信息。
该接口会检查图片格式是否支持解码,如果遇到不支持的码流则该接口会返回HI_ERR_VDEC_NOT_SUPPORT错误码,该错误码的详细描述请参见公共返回码。
Atlas 200/300/500 推理产品,不支持该接口。
Atlas 训练系列产品,不支持该接口。
函数原型
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上的内存地址。 |
output_format |
输入 |
输出图片格式。 若按源图格式获取相关信息,则将该参数值设置为HI_PIXEL_FORMAT_UNKNOWN;若按指定格式获取相关信息,则将该参数值设置为对应的图片格式,支持的图片格式请参见图片格式、宽高对齐、内存约束。 |
img_info |
输出 |
输出图片信息结构体,包含图片宽、高、宽stride、高stride、解码后占用的内存大小、图片格式等信息。 其中,输出图片格式,通过img_pixel_format参数返回。 |
返回值说明
- 0:成功
- 非0:失败,参见公共返回码、VDEC视频解码/JPEGD图片解码返回码。