acldvppCreateChannel

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 an image processing 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.
  • Do not use a channel concurrently across streams.
  • acldvppCreateChannel internally calls aclrtCreateStream once to create a stream. The stream is used to create a channel task. After the channel creation task is complete, the stream resources are automatically released.

    When creating a stream, you must comply with the restrictions of the aclrtCreateStream API, for example, the number of streams.

Prototype

1
aclError acldvppCreateChannel(acldvppChannelDesc *channelDesc)

Parameters

Parameter

Input/Output

Description

channelDesc

Input/Output

Pointer to the channel description.

Call the acldvppCreateChannelDesc API to create data of the acldvppChannelDesc type in advance.

In addition, you need to call the acldvppSetChannelDescMode API to specify the channel mode in the channel description and specify the function to be implemented by the image data processing channel. Currently, the VPC, JPEGD, JPEGE, and PNGD functions are supported. If the channel mode is not specified, the system creates channels in the four modes by default, which may occupy channel resources. For details about the limit on the number of channels, see Functions and Restrictions.

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.