acltdtCreateChannel

Applicable Products

Product	Supported
Ascend 950PR/Ascend 950DT	☓
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 data of the acltdtChannelHandle type as a data TX channel to or RX channel from the device. After the channel is used, call acltdtStopChannel and acltdtDestroyChannel in sequence to destroy channel resources.

For the Atlas training product, this API is supported only in the Ascend virtual instance scenario.

Prototype

acltdtChannelHandle *acltdtCreateChannel(uint32_t deviceId, const char *name)

Parameters

Parameter	Input/Output	Description
deviceId	Input	Device ID. Must be in the range of [0, Device count – 1]. Call aclrtGetDeviceCount to obtain the device count.
name	Input	Pointer to the channel name.

Parameter

Input/Output

Description

deviceId

Input

Device ID.

Must be in the range of [0, Device count – 1]. Call aclrtGetDeviceCount to obtain the device count.

name

Input

Pointer to the channel name.

Returns

Success: a pointer to data of the acltdtChannelHandle type
Failure: nullptr

Parent topic: Tensor Data Transfer