aclrtFreePhysical

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product / Atlas A3 inference product	√
Atlas A2 training product / Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

Description

Frees the physical memory allocated by the aclrtMallocPhysical call.

If the physical memory is mapped to virtual memory, the physical memory will not be actually freed. The physical memory is actually freed only after the mapping between the physical memory and the virtual memory is canceled by calling aclrtUnmapMem.

Prototype

      
           aclError aclrtFreePhysical(aclrtDrvMemHandle handle)

Parameters

Parameter	Input/Output	Description
handle	Input	Handle for storing information about the physical memory to be freed. For details about the type definition, see aclrtDrvMemHandle.

Returns

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

Restrictions

This API is not supported in the Ascend RC form of the Atlas 200I/500 A2 inference product .

API Call Example

For the API call example, see Virtual Memory Management.

Parent topic: Memory Management