停止指定Stream上的正在执行的任务、丢弃指定Stream上已下发但未执行的任务。本接口执行期间,指定Stream上新下发的任务不再生效。
如果有其它Stream依赖本接口中指定的Stream(例如通过aclrtRecordEvent、aclrtStreamWaitEvent等接口实现两个Stream间同步等待),则其它Stream执行可能会卡住,此时您需要显式调用本接口清除其它Stream上的任务。
如果调用本接口清除指定Stream上的任务时,再调用同步等待接口(例如aclrtSynchronizeStream、aclrtSynchronizeEvent等),同步等待接口会退出并返回ACL_ERROR_RT_STREAM_ABORT的报错。
aclError aclrtStreamAbort(aclrtStream stream)
参数名 |
输入/输出 |
说明 |
---|---|---|
stream |
输入 |
指定待清除任务的Stream。 不支持传NULL,否则返回报错。 |
返回0表示成功,返回其他值表示失败,请参见aclError。