Function: destroy_stream

Product	Supported (√/x)
Atlas A3 training products / Atlas A3 inference products	√
Atlas A2 training products / Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

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 example, see Runtime Resource Allocation and Deallocation and Synchronous Wait.

Parent topic: Streams Management