aclrtMallocPhysical
函数功能
申请物理内存,并返回一个物理内存handle。
Atlas 200/300/500 推理产品,不支持该接口。
Atlas 推理系列产品,不支持该接口。
Atlas 200I/500 A2推理产品,不支持该接口。
本接口需与以下其它接口配合使用,以便申请地址连续的虚拟内存、最大化利用物理内存地址的目的:
- 申请虚拟内存(aclrtReserveMemAddress接口);
- 申请物理内存(aclrtMallocPhysical接口);
- 将虚拟内存映射到物理内存(aclrtMapMem接口);
- 执行任务(调用具体的任务接口);
- 取消虚拟内存与物理内存的映射(aclrtUnmapMem接口);
- 释放物理内存(aclrtFreePhysical接口);
- 释放虚拟内存(aclrtReleaseMemAddress接口)。
约束说明
- Ascend RC形态不支持调用本接口。
- 当前版本仅支持ACL_HBM_MEM_HUGE(表示HBM大页内存)、ACL_HBM_MEM_NORMAL(表示HBM普通页内存)两种内存类型,若传入ACL_HBM_MEM_NORMAL类型,系统内部当前也按HBM大页内存申请。
在Atlas 推理系列产品上,由于Device上没有HBM内存,使用本接口申请ACL_HBM_MEM_HUGE类型的内存时,AscendCL系统内部自动转换为申请ACL_DDR_MEM_HUGE类型的DDR内存。
在 Atlas 200I/500 A2推理产品上,由于Device上没有HBM内存,使用本接口申请ACL_HBM_MEM_HUGE类型的内存时,AscendCL系统内部自动转换为申请ACL_DDR_MEM_HUGE类型的DDR内存。
函数原型
aclError aclrtMallocPhysical(aclrtDrvMemHandle *handle, size_t size, const aclrtPhysicalMemProp *prop, uint64_t flags)
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
handle |
输出 |
存放物理内存信息的handle。 |
size |
输入 |
物理内存大小,单位Byte。 size当前需按照2M对齐。 |
prop |
输入 |
物理内存属性信息。 |
flags |
输入 |
预留,当前只能设置为0。 |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 内存管理