aclrtReleaseMemAddress

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	√

Frees the virtual memory allocated by the aclrtReserveMemAddress call.

This API must be used together with other APIs to allocate virtual memory with consecutive addresses and maximize the use of physical memory.

Call aclrtReserveMemAddress to allocate virtual memory.
Call aclrtMallocPhysical to allocate physical memory.
Call aclrtMapMem to map virtual memory to physical memory.
Call specific task APIs to execute tasks.
Call aclrtUnmapMem to cancel the mapping between virtual memory and physical memory.
Call aclrtFreePhysical to free physical memory.
Call aclrtReleaseMemAddress to free virtual memory.

      
           aclError aclrtReleaseMemAddress(void *virPtr)

Parameter	Input/Output	Description
virPtr	Input	Pointer to the address of the virtual memory to be freed.

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

Atlas 200I/500 A2 inference products in Ascend RC form: This API is not supported.

If the virtual memory is mapped to physical memory, you need to unmap them by calling aclrtUnmapMem before freeing the virtual memory.

For the API call example, see Virtual Memory Management.

Parent topic: Virtual Memory Management