Function: vdec_create_channel

aclError aclvdecCreateChannel(aclvdecChannelDesc *channelDesc)

ret = acl.media.vdec_create_channel(vdec_channel_desc)

Creates a video processing channel, which is reusable. After being destroyed, the channel is no longer available.

vdec_channel_desc: int, pointer address of the channel description.

Use the acl.media.vdec_create_channel_desc call to create data of the vdec_channel_desc type, and use the acl.media.vdec_set_channel_desc APIs to set the attributes of the channel description.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

• Channels are thread-unsafe, that is, a separate channel should be created for each thread.
• The restrictions on the number of channels are described in General Description.
• The acl.media.vdec_create_channel API encapsulates acl.rt.create_stream and acl.rt.subscribe_report APIs.
  • Two streams are created by calling acl.rt.create_stream twice. One is for the video stream decoding task, and the other is for processing the callback function. These streams can be automatically destroyed only after the channel is destroyed by calling acl.media.vdec_destroy_channel.
  • Call acl.rt.subscribe_report to specify a thread for processing the callback function in a stream. The callback function and thread are specified by using the acl.media.vdec_set_channel_desc calls.

  In the implementation of VDEC, acl.rt.create_stream and acl.rt.subscribe_report do not need to be called separately. Note that acl.rt.create_stream and acl.rt.subscribe_report have restrictions (particularly, on the number of streams and the number of threads that handle the callback functions in the streams) and these restrictions must be met.

For details about the API call sequence and example, see Media Data Processing V1.