aclrtMallocPhysical

函数功能

申请物理内存,并返回一个物理内存handle。

Atlas 200/300/500 推理产品,不支持该接口。

Atlas 推理系列产品,不支持该接口。

Atlas 200I/500 A2推理产品,不支持该接口。

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

约束说明

函数原型

aclError aclrtMallocPhysical(aclrtDrvMemHandle *handle, size_t size, const aclrtPhysicalMemProp *prop, uint64_t flags)

参数说明

参数名

输入/输出

说明

handle

输出

存放物理内存信息的handle。

size

输入

物理内存大小,单位Byte。

size当前需按照2M对齐。

prop

输入

物理内存属性信息。

flags

输入

预留,当前只能设置为0。

返回值说明

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