acldvppCreateChannel

Applicability

Product

Supported

Atlas A3 training products / Atlas A3 inference products

Atlas A2 training products / Atlas A2 inference products

Atlas 200I/500 A2 inference products

Atlas inference products

Atlas training products

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 API creates a stream internally by calling aclrtCreateStream once. The stream is used for the channel creation task. When the task is complete, the stream is automatically destroyed.

    When creating a channel, observe the restrictions of aclrtCreateStream, such as the number of streams.

Prototype

aclError acldvppCreateChannel(acldvppChannelDesc *channelDesc)

Parameters

Parameter

Input/Output

Description

channelDesc

Input/Output

Pointer to the channel description.

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

In addition, you need to call acldvppSetChannelDescMode 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. Unless the channel mode is specified, the system creates all these modes of channels by default, which may occupy more channel resources. (For details about the limit on the number of channels, see Overview.)

Returns

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

See Also

For details about the API call sequence and example, see DVPP Image/Video Processing (V1).