aclrtStreamAbort

产品支持情况

功能说明

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

函数原型

1

aclError aclrtStreamAbort(aclrtStream stream)

参数说明

返回值说明

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

约束说明

• 本接口中的Stream不支持与模型运行实例绑定过的Stream。模型运行实例与Stream的绑定请参见aclmdlRIBindStream接口。
• 不支持如下方式创建的Stream：调用aclrtCreateStreamWithConfig接口，将flag设置为ACL_STREAM_DEVICE_USE_ONLY（表示该Stream仅在Device上调用）。
• 如果有其他Stream依赖本接口中指定的Stream（例如通过aclrtRecordEvent、aclrtStreamWaitEvent等接口实现两个Stream间同步等待），则其他Stream执行可能会卡住，此时您需要显式调用本接口清除其他Stream上的任务。
• 如果调用本接口清除指定Stream上的任务时，再调用同步等待接口（例如aclrtSynchronizeStream、aclrtSynchronizeEvent等），同步等待接口会退出并返回ACL_ERROR_RT_STREAM_ABORT的报错。
• 对于Ascend 950PR/Ascend 950DT，不支持如下方式创建的Stream：调用aclrtCreateStreamWithConfig，将flag设置为ACL_STREAM_PERSISTENT。