hi_mpi_venc_request_idr
The
The
Description
Requests for an instantaneous decoding refresh (IDR) frame.
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 OT_VENC_GOP_MODE_SMART_P or B-frame mode, the request for the IDR frame takes effect after a delay.
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. |
instant |
Input |
Whether to instantly encode an IDR frame. |
Returns
- 0: success
- Other values: failure. For details, see VENC/JPEGE Return Codes.
Parent topic: VENC/JPEGE