hi_mpi_venc_request_idr

Applicability

Product	Supported
Atlas 350 Accelerator Card	☓
Atlas A3 training product/Atlas A3 inference product	☓
Atlas A2 training product/Atlas A2 inference product	☓
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	☓

Function Description

Requests for an instantaneous decoding refresh (IDR) frame.

Prototype

hi_s32 hi_mpi_venc_request_idr(hi_venc_chn chn, hi_bool instant)

Parameters

Parameter	Input/Output	Description
chn	Input	Encoding channel ID. Atlas 350 Accelerator Card: encoding channel ID. The value range is as follows: [0, 256). The maximum number of JPEGE channels is 256. Atlas A3 training product/Atlas A3 inference product: The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas A2 training product/Atlas A2 inference product: The value range of the encoding channel ID is [0, 256). The maximum number of JPEGE channels is 256. Atlas 200I/500 A2 inference product: 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. For the Atlas inference product, the value range of the encoding channel ID is [0, 256). The JPEGE and VENC functions share channels. The maximum number of channels is 256.
instant	Input	Whether to instantly encode an IDR frame.

Parameter

Input/Output

Description

chn

Input

Encoding channel ID.

Atlas 350 Accelerator Card: encoding channel ID. The value range is as follows: [0, 256). The maximum number of JPEGE channels is 256.

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

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

Atlas 200I/500 A2 inference product: 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.

For the Atlas inference product, the value range of the encoding channel ID is [0, 256). The JPEGE and VENC functions share channels. The maximum number of channels is 256.

instant

Input

Whether to instantly encode an IDR frame.

Returns

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

Restrictions

Ensure that a channel has been created. Otherwise, a failure is returned.
After an IDR frame request is received, if instant is 0, an IDR frame is encoded in the next frame as controlled by the frame rate controller; if instant is 1, an IDR frame is encoded instantly.
IDR frame requesting is applicable to H.264 and H.265 encoding.
Typically, the destination frame rate is the same as the source frame rate. Therefore, frame rate control has no impact on this API. Regardless of the setting of instant (either 0 or 1), an IDR frame is encoded on every call to this API. Note that too frequent calls to this API cause fluctuations in the frame rate and bit rate of the stream.
When the GOP mode is Smart P-frame or B-frame, the IDR frame request takes effect after a delay.
Atlas inference product. Currently, the Smart P-frame or B-frame mode is not supported.

Currently, the Atlas 200I/500 A2 inference product does not support B-frame mode.

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