aclrtFree

Applicable Products

Product

Supported

Ascend 950PR / Ascend 950DT

Atlas A3 training products / Atlas A3 inference products

Atlas A2 training products / Atlas A2 inference products

Atlas 200I/500 A2 inference products

Atlas inference products

Atlas training products

Function

Frees device memory.

This API immediately frees the input memory. It does not perform implicit device synchronization or stream synchronization or wait until the tasks that use the memory are complete. Ensure that the memory pointer is not accessed after this API is called.

Prototype

1
aclError aclrtFree(void *devPtr)

Parameters

Parameter

Input/Output

Description

devPtr

Input

Pointer to memory to free.

If a null pointer is passed, this API returns an error.

Returns

0 on success; otherwise, failure. For details, see aclError.

Restrictions

aclrtFree can only free the memory allocated through the aclrtMalloc, aclrtMallocCached, or aclrtMallocAlign32 API.

API Call Example

For the API call example, see Device Memory Usage.