Function: unmap_mem
Applicability
Product |
Supported (√/x) |
|---|---|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
Function Usage
Unmaps virtual memory from physical memory.
This API needs to work with other APIs to allocate virtual memory with consecutive addresses and maximize the use of physical memory.
- Call acl.rt.reserve_mem_address to allocate virtual memory.
- Call acl.rt.malloc_physical to allocate physical memory.
- Call acl.rt.map_mem to map the virtual memory to the physical memory.
- Call specific task APIs to execute tasks.
- Call acl.rt.unmap_mem to unmap the virtual memory from the physical memory.
- Call acl.rt.free_physical to free the physical memory.
- Call acl.rt.release_mem_address to free the virtual memory.
Prototype
- C Prototype
1aclError aclrtUnmapMem(void *virPtr)
- Python Function
1ret = acl.rt.unmap_mem(vir_ptr)
Parameter Description
Parameter |
Description |
|---|---|
vir_ptr |
Int, virtual address to be unmapped. |
Return Value Description
Return Value |
Description |
|---|---|
ret |
Int, error code: 0 on success; else, failure. |
Restrictions
This API is not supported in the Ascend RC form.
Parent topic: Memory Management