aclrtStreamAbort

Atlas 200/300/500 推理产品,不支持该接口。

Atlas 训练系列产品,不支持该接口。

Atlas 推理系列产品,不支持该接口。

Atlas 200I/500 A2 推理产品不支持该接口。

函数功能

停止指定Stream上的正在执行的任务、丢弃指定Stream上已下发但未执行的任务。本接口执行期间,指定Stream上新下发的任务不再生效。

约束说明

如果有其它Stream依赖本接口中指定的Stream(例如通过aclrtRecordEventaclrtStreamWaitEvent等接口实现两个Stream间同步等待),则其它Stream执行可能会卡住,此时您需要显式调用本接口清除其它Stream上的任务。

如果调用本接口清除指定Stream上的任务时,再调用同步等待接口(例如aclrtSynchronizeStreamaclrtSynchronizeEvent等),同步等待接口会退出并返回ACL_ERROR_RT_STREAM_ABORT的报错。

函数原型

aclError aclrtStreamAbort(aclrtStream stream)

参数说明

参数名

输入/输出

说明

stream

输入

指定待清除任务的Stream。

不支持传NULL,否则返回报错。

返回值说明

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