---
title: aclrtFreePhysical
description: "释放通过aclrtMallocPhysical接口申请的物理地址空间。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0119.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0119.html
indexId: 892a23a43e39133f3e4ec98d70acc423752c5b0abe0da18f766b6b773e919a02105
---
# aclrtFreePhysical

#### 函数功能

释放通过aclrtMallocPhysical接口申请的物理地址空间。

本接口需与以下其它接口配合使用，以便申请连续的虚拟内存地址、最大化利用物理内存地址的目的：1. 申请虚拟地址空间（  aclrtReserveMemAddress
接口）；
2. 申请物理内存（  aclrtMallocPhysical
接口）；
3. 将虚拟地址映射到物理内存（  aclrtMapMem
接口）；
4. 执行任务（调用具体的任务接口）；
5. 取消虚拟地址与物理内存的映射（  aclrtUnmapMem
接口）；
6. 释放物理内存（  aclrtFreePhysical
接口）；
7. 释放虚拟地址空间（  aclrtReleaseMemAddress
接口）。


#### 约束说明

- Ascend RC形态不支持调用本接口。
- 若该物理地址与虚拟地址存在映射关系，则释放物理地址空间前，需调用  aclrtUnmapMem
接口取消该物理地址与虚拟地址的映射。


#### 函数原型

aclError aclrtFreePhysical(aclrtDrvMemHandle handle)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| handle | 输入 | 待释放的物理地址信息handle。 |


#### 返回值说明

返回0表示成功，返回其它值表示失败。
