acltdtReceiveTensor

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	x
Atlas 推理系列产品	x
Atlas 训练系列产品	√
Atlas 200/300/500 推理产品	x

在Host接收Device发过来的数据。

aclError acltdtReceiveTensor(const acltdtChannelHandle *handle, acltdtDataset *dataset, int32_t timeout)

参数名	输入/输出	说明
handle	输入	指定通道。需提前调用acltdtCreateChannel接口或acltdtCreateChannelWithCapacity接口创建acltdtChannelHandle类型的数据。
dataset	输出	接收到的Device数据的指针。
timeout	输入	等待超时时间。该参数取值范围如下： -1：阻塞方式，一直等待直到数据接收完成。 0：非阻塞方式，当通道空时，直接返回通道空这个错误，这时由用户自行设定重试间隔。 >0：配置具体的超时时间，单位为毫秒。通道空时，等待达到超时时间后返回报错。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的超时时间为1ms，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

参数名

输入/输出

说明

handle

输入

指定通道。

需提前调用acltdtCreateChannel接口或acltdtCreateChannelWithCapacity接口创建acltdtChannelHandle类型的数据。

dataset

输出

接收到的Device数据的指针。

timeout

输入

等待超时时间。

该参数取值范围如下：

-1：阻塞方式，一直等待直到数据接收完成。
0：非阻塞方式，当通道空时，直接返回通道空这个错误，这时由用户自行设定重试间隔。
>0：配置具体的超时时间，单位为毫秒。通道空时，等待达到超时时间后返回报错。超时时间受操作系统影响，一般偏差在操作系统的一个时间片内，例如，操作系统的一个时间片为4ms，用户设置的超时时间为1ms，则实际的超时时间在1ms到5ms范围内。在CPU负载高场景下，超时时间仍可能存在波动。

返回0表示成功，返回其他值表示失败，请参见aclError。

父主题： Tensor数据传输