下载
中文
注册

函数: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 推理产品不支持该接口。

输入说明

acl.get_cann_attribute_list

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

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

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

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

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

返回值说明

ret:int,错误码。

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

约束说明

  • Ascend RC形态不支持调用本接口。
  • 当前版本仅支持“ACL_HBM_MEM_HUGE”(表示片上内存大页内存)、“ACL_HBM_MEM_NORMAL”(表示片上内存普通页内存)两种内存类型,若传入“ACL_HBM_MEM_NORMAL”类型,系统内部当前也按片上内存大页内存申请。

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

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