昇腾社区首页
中文
注册

函数:stream_abort

C函数原型

aclError aclrtStreamAbort(aclrtStream stream)

Python函数

ret = acl.rt.stream_abort(stream)

函数功能

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

输入说明

stream:int,指定待清除任务的Stream。不支持传NULL,否则返回报错。

返回值说明

ret:int,返回0表示成功,返回其他值表示失败。

约束说明

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

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