hi_mpi_dvpp_get_image_info

Applicability

Product	Supported
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas 200I/500 A2 inference products	√
Atlas inference products	√
Atlas training products	x

Description

Obtains the output width, height, width stride, height stride, and buffer size as well as the source image format when the source image format is retained after decoding. This API checks whether the image format supports decoding. For an unsupported stream, the API returns the error code HI_ERR_VDEC_NOT_SUPPORT. For details, see VDEC/JPEGD Return Codes.

Prototype

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

Parameters

Parameter	Input/Output	Description
img_type	Input	Type of the stream to parse. Currently, the stream type can only be HI_PT_JPEG.
stream	Input	Pointer to the input stream information. Atlas inference products: In Ascend EP form, when this API is called on the host, the configured addr must be a buffer address on the host. Atlas 200I/500 A2 inference products: In Ascend EP form, when this API is called on the host, the configured addr must be a buffer address on the host. Atlas 200I/500 A2 inference products: In Ascend RC form, when this API is called on the device, the configured addr must be a buffer address on the device. Atlas A2 training products/Atlas A2 inference products: When this API is called on the host, the configured addr must be a buffer address on the host. Atlas A3 training products/Atlas A3 inference products: When this API is called on the host, the configured addr must be a buffer address on the host.
img_info	Output	Pointer to the image information, including the image width, height, width stride, height stride, buffer size occupied after decoding, and source image format. The source image format is returned through the pixel_format parameter.

Parameter

Input/Output

Description

img_type

Input

Type of the stream to parse.

Currently, the stream type can only be HI_PT_JPEG.

stream

Input

Pointer to the input stream information.

Atlas inference products: In Ascend EP form, when this API is called on the host, the configured addr must be a buffer address on the host.

Atlas 200I/500 A2 inference products: In Ascend EP form, when this API is called on the host, the configured addr must be a buffer address on the host.

Atlas 200I/500 A2 inference products: In Ascend RC form, when this API is called on the device, the configured addr must be a buffer address on the device.

Atlas A2 training products/Atlas A2 inference products: When this API is called on the host, the configured addr must be a buffer address on the host.

Atlas A3 training products/Atlas A3 inference products: When this API is called on the host, the configured addr must be a buffer address on the host.

img_info

Output

Pointer to the image information, including the image width, height, width stride, height stride, buffer size occupied after decoding, and source image format.

The source image format is returned through the pixel_format parameter.

Returns

0: success
Other values: failure. For details, see VDEC/JPEGD Return Codes.

Parent topic: Common APIs