acl.himpi.venc_start_chn

C Prototype

hi_s32 hi_mpi_venc_start_chn (hi_venc_chn chn, const hi_venc_start_param *recv_param);

Python Function

ret = acl.himpi.venc_start_chn(chn, recv_param)

Function Usage

Enables an encoding channel to start receiving source images. The encoding channel automatically stops receiving images when the specified receive limit is reached.

The Atlas 200/300/500 Inference Product does not support this API in the current version.

The Atlas Training Series Product does not support this API in the current version.

Input Description

chn: int, encoding channel ID.

recv_param: dict, dictionary of image receive parameters, which specifies the number of frames to receive. For details, see hi_venc_start_param.

Return Value

ret: int, error code.

Restrictions

  • Ensure that a channel has been created. Otherwise, the error code HI_ERR_VENC_UNEXIST is returned.
  • The value -1 indicates that an unspecified number of frames will be received.
  • For a channel already in the image receiving progress, if this API is called to specify its frame receive limit, an error code is returned indicating that this request is illegal.
  • If a channel has started to receive images, you can call this API again without specifying the number of frames to be received before the channel stops receiving images.
  • The encoder starts encoding images only after its channel has started receiving images.