vdec_set_chn_param

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas training product

x

Atlas inference product

Atlas 200I/500 A2 inference product

Description

Sets the decoding channel parameters.

Prototype

  • C Prototype
    1
    hi_s32 hi_mpi_vdec_set_chn_param(hi_vdec_chn chn, const hi_vdec_chn_param *chn_param)
    
  • Python Function
    1
    ret = acl.himpi.vdec_set_chn_param(chn, chn_param)
    

Parameters

Parameter

Description

chn

Int, decoding channel ID.

chn_param

Dict, dictionary of decoding channel parameters. For details, see hi_vdec_chn_param.

Return Value

Return Value

Description

ret

Int, error code.

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.
  • When creating a channel by calling acl.himpi.vdec_create_chn, set streams to be sent by frame (currently, streams can be sent only by frame). In addition, you can call this API to set the output stream order to the decoding sequence, that is, chn_param["video_param"]["out_order"] = HI_VIDEO_OUT_ORDER_DEC, to implement fast decoding and output. However, this does not support streams containing B frames.

Reference

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