hi_mpi_vdec_set_chn_param

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

Description

Sets the decoding channel parameters.

Prototype

hi_s32 hi_mpi_vdec_set_chn_param (hi_vdec_chn chn, const hi_vdec_chn_param *chn_param)

Parameters

Parameter

Input/Output

Description

chn

Input

Decoding channel ID.

Atlas A3 training products / Atlas A3 inference products : The value range of this parameter is [0, 256). The JPEGD and VDEC functions share the same channels, and the maximum number of channels is 256. Among them, a maximum of 256 JPEGD decoding channels and 32 VDEC decoding channels are supported.

Atlas A2 training products / Atlas A2 inference products : The value range of this parameter is [0, 256). The JPEGD and VDEC functions share the same channels, and the maximum number of channels is 256. Among them, a maximum of 256 JPEGD decoding channels and 32 VDEC decoding channels are supported.

Atlas 200I/500 A2 inference products : The value range of this parameter is [0, 128). The JPEGD and VDEC 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 JPEGD and VDEC functions share the same channels, and the maximum number of channels is 256.

chn_param

Input

Pointer to the decoding channel parameters.

Returns

Restrictions

  • Ensure that a channel has been created. Otherwise, the error code HI_ERR_VDEC_UNEXIST is returned.
  • This API can be used to set advanced channel parameters. A created channel has default values for these parameters, as described in hi_vdec_chn_param.
  • If the value of a parameter is out of the valid range, the error code HI_ERR_VDEC_ILLEGAL_PARAM is returned. For the value range of each parameter, see the description of hi_vdec_chn_param.
  • Set streams to be sent by frame (the only mode supported currently) when creating a channel by calling the hi_mpi_vdec_create_chn API. Call this API to set the output stream order to the decoding sequence, that is, set chn_param->video_param.out_order of this API to HI_VIDEO_OUT_ORDER_DEC. In this way, streams can be decoded and output quickly. However, this method is not applicable to streams containing B-frames.

See Also

For details about the API call sequence and example, see JPEGD and VDEC.