函数：map_mem
产品支持情况
产品 |
是否支持 |
|---|---|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
|
√ |
使用说明
C函数原型 |
aclError aclrtMapMem(void *virPtr, size_t size, size_t offset, aclrtDrvMemHandle handle, uint64_t flags) |
|---|---|
Python函数 |
ret = acl.rt.map_mem(vir_ptr, size, offset, handle, flags) |
函数功能 |
将虚拟内存映射到物理内存。 本接口需与以下其它接口配合使用，以便申请地址连续的虚拟内存、最大化利用物理内存的目的：
|
输入说明 |
vir_ptr：int，待映射的虚拟地址。该地址不一定为起始地址，用户也可以根据起始地址自行偏移后，再映射。虚拟地址当前需按照2M对齐。 size：int，待映射的内存大小，单位Byte。size当前需按照2M对齐。 offset：int，物理内存偏移值，当前只能设置为0。 handle：int，物理内存指针地址。 通过acl.rt.reserve_mem_address接口预留出来的一整段虚拟地址，由用户自行管理、划分时，不能同时与两个Device上申请的物理地址绑定。 通过acl.rt.reserve_mem_address接口预留出来的一整段虚拟地址，由用户自行管理、划分时，不能同时与acl.rt.malloc_physical、acl.rt.mem_import_from_shareable_handle接口输出的handle绑定。 flags：int，预留，当前仅支持设置为0。 |
返回值说明 |
ret：int，错误码。
|
约束说明 |
Ascend RC形态不支持调用本接口。 |