Function: venc_create_channel

Applicability

Product	Supported
Atlas 350 Accelerator Card	x
Atlas A3 training product / Atlas A3 inference product	x
Atlas A2 training product / Atlas A2 inference product	x
Atlas training product	x
Atlas inference product	√
Atlas 200I/500 A2 inference product	√

Description

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

Prototype

C Prototype

        
             aclError aclvencCreateChannel(aclvencChannelDesc *channelDesc)

Python Function

        
             ret = acl.media.venc_create_channel(venc_channel_desc)

Parameters

Parameter	Description
venc_channel_desc	Int, channel description. Use the acl.media.venc_create_channel_desc call to create data of the aclvencChannelDesc type, and use the acl.media.venc_set_channel_desc series calls to set the attributes of the channel description.

Parameter

Description

venc_channel_desc

Int, channel description.

Use the acl.media.venc_create_channel_desc call to create data of the aclvencChannelDesc type, and use the acl.media.venc_set_channel_desc series calls to set the attributes of the channel description.

Return Value

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Restrictions

Channels are thread-unsafe, that is, a separate channel should be created for each thread.
For details about the maximum number of channels, see Functions and Restrictions.
acl.media.venc_create_channel internally calls acl.rt.create_stream twice to create two streams. One stream is used for video stream encoding, and the other stream is used for callback function processing. These streams can be automatically destroyed only after the channel is destroyed by calling acl.media.venc_destroy_channel.
When implementing the VENC function, you must comply with the restrictions of the acl.rt.create_stream API, such as the number of streams.

Reference

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

Parent topic: VENC Channel