aclvencCreateChannel

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product / Atlas A3 inference product

Atlas A2 training product / Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Function Description

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

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.
  • aclvencCreateChannel calls aclrtCreateStream twice to create two streams. One stream is used for video stream encoding, and the other stream is used for callback function processing. The stream resources can be automatically released only after the channel is destroyed by calling aclvencDestroyChannel.

    When implementing the VENC function, you must comply with the restrictions of aclrtCreateStream, for example, the number of streams.

Prototype

1
aclError aclvencCreateChannel(aclvencChannelDesc *channelDesc)

Parameters

Parameter

Input/Output

Description

channelDesc

Input/Output

Pointer to the channel description.

Call the aclvencCreateChannelDesc API to create data of the aclvencChannelDesc type in advance, and then call the aclvencSetChannelDesc series APIs to set the attributes of the channel description.

Returns

0 on success; otherwise, failure. For details, see aclError.

See Also

For details about the API call sequence and examples, see Media data processing V1.