昇腾社区首页
中文
注册

函数:malloc_physical

C函数原型

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

Python函数

handle, ret = acl.rt.malloc_physical(size, prop, flags)

函数功能

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

本接口可配合acl.rt.reserve_mem_address接口(申请虚拟内存)、acl.rt.map_mem接口(建立虚拟内存与物理内存之间的映射)使用,以便申请地址连续的虚拟内存、最大化利用物理内存地址的目的。

本接口可配合acl.rt.mem_export_to_shareable_handle接口(导出物理内存handle)、acl.rt.mem_import_from_shareable_handle(导入共享handle)使用,用于实现多进程之间的物理内存共享。同时,也支持在共享物理内存时,使用虚拟内存,请参见acl.rt.mem_export_to_shareable_handle接口处的说明。

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

输入说明

size:int,物理地址空间大小,单位Byte。

先调用acl.rt.mem_get_allocation_granularity接口获取内存申请粒度,然后再调用本接口申请物理内存时size按获取到的内存申请粒度对齐,以便节约内存。

当前内存申请粒度固定2M,因此size当前需按照2M对齐。

prop:dict,物理内存属性信息,具体请参见aclrtPhysicalMemProp

flags:int,预留,当前仅支持设置为0。

返回值说明

ret:int,错误码。

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

约束说明

  • Atlas 200I/500 A2 推理产品上,Ascend RC形态不支持调用本接口。
  • 当前版本仅支持ACL_HBM_MEM_HUGE(2M粒度对齐的大页内存)、ACL_HBM_MEM_HUGE1G(1G粒度对齐的大页内存)、ACL_HBM_MEM_NORMAL(普通页内存)类型的内存,即使传入ACL_HBM_MEM_NORMAL类型,系统内部也会按照ACL_HBM_MEM_HUGE类型申请大页内存。

    Atlas 200I/500 A2 推理产品Atlas 推理系列产品上,由于Device上没有片上内存,使用本接口申请ACL_HBM_MEM_HUGE类型的内存时,系统内部自动转换为申请ACL_DDR_MEM_HUGE类型的DDR内存。

    在上,由于Device上没有片上内存,使用本接口申请ACL_HBM_MEM_HUGE类型的内存时,系统内部自动转换为申请ACL_DDR_MEM_HUGE类型的DDR内存。