acldvppCreateChannel

Applicable Products

Product

Supported

Ascend 950PR / Ascend 950DT

x

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

√

Function

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

1
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 Functions and Restrictions.)

Returns

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

Reference

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