Function: destroy_stream

Destroys a stream created by the acl.rt.create_stream or acl.rt.create_stream_with_config call. If there are unfinished tasks on the stream, the stream is destroyed after the tasks are complete.

C Prototype

        
             aclError aclrtDestroyStream(aclrtStream stream)

Parameter	Description
stream	Int, pointer address of the stream to be destroyed.

Return Value	Description
ret	Int, error code. 0 on success; else, failure.

Before calling acl.rt.destroy_stream to destroy a specified stream, call acl.rt.synchronize_stream to ensure that all tasks in the stream are completely executed.
When calling acl.rt.destroy_stream to destroy a specified stream, ensure that the stream is in the current context.
When calling acl.rt.destroy_stream to destroy a specified stream, ensure that the stream is not being used by other APIs.

For details about the API call sequence and examples, see Runtime Resource Allocation and Deallocation and Synchronous Wait.

Parent topic: Streams Management