下载
中文
注册

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表示成功,返回其它值表示失败。