hi_mpi_venc_release_stream

Applicable Products

Product	Supported
Ascend 950PR / Ascend 950DT	√
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	☓

Function

Frees the stream buffer.

This API must work with hi_mpi_venc_get_stream. You are advised to free the obtained stream buffer to prevent the stream buffer from being full, which can affect encoding. In addition, you must comply with the principle of "first obtained, first freed".

Prototype

hi_s32 hi_mpi_venc_release_stream(hi_venc_chn chn, hi_venc_stream *stream)

Parameters

Parameter	Input/Output	Description
chn	Input	Encoding channel ID. Ascend 950PR / Ascend 950DT : The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas A3 training products / Atlas A3 inference products : The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas A2 training products / Atlas A2 inference products : The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas 200I/500 A2 inference products : The value range of this parameter is [0, 128). The JPEGE and VENC functions share the same channels, and the maximum number of channels is 128. Atlas inference products : The value range of this parameter is [0, 256). The JPEGE and VENC functions share the same channels, and the maximum number of channels is 256.
stream	Input	Pointer to the encoded stream. If stream is left empty, the error code HI_ERR_VENC_NULL_PTR is returned.

Parameter

Input/Output

Description

chn

Input

Encoding channel ID.

Ascend 950PR / Ascend 950DT : The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256.

Atlas A3 training products / Atlas A3 inference products : The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256.

Atlas A2 training products / Atlas A2 inference products : The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256.

Atlas 200I/500 A2 inference products : The value range of this parameter is [0, 128). The JPEGE and VENC functions share the same channels, and the maximum number of channels is 128.

Atlas inference products : The value range of this parameter is [0, 256). The JPEGE and VENC functions share the same channels, and the maximum number of channels is 256.

stream

Input

Pointer to the encoded stream.

If stream is left empty, the error code HI_ERR_VENC_NULL_PTR is returned.

Returns

0: success
Other values: failure. For details, see VENC/JPEGE Return Codes.

Restrictions

Ensure that a channel has been created. Otherwise, the error code HI_ERR_VENC_UNEXIST is returned.
When an encoding channel is reset, the stream buffer becomes invalid, even if the packets are not freed.
An attempt to free the buffer of an invalid stream returns the HI_ERR_VENC_ILLEGAL_PARAM error.

Reference

For details about the API call sequence and example, see JPEGE and VENC.

Parent topic: Video Encoder (VENC) and JPEG Encoder (JPEGE)