aclrtMapMem

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√
Atlas 200/300/500 推理产品	√

将虚拟内存映射到物理内存。

本接口需与以下其它接口配合使用，以便申请地址连续的虚拟内存、最大化利用物理内存：

aclError aclrtMapMem(void *virPtr, size_t size, size_t offset, aclrtDrvMemHandle handle, uint64_t flags)

参数名	输入/输出	说明
virPtr	输入	待映射的虚拟内存地址指针。这个地址不一定是起始地址，用户也可以根据起始地址自行偏移后，再映射。虚拟内存地址当前需按照2M对齐。
size	输入	待映射的内存大小，单位Byte。 size当前需按照2M对齐。
offset	输入	物理内存偏移值，当前只能设置为0。
handle	输入	物理内存信息handle。通过aclrtReserveMemAddress接口预留出来的一整段虚拟地址，由用户自行管理、划分时，不能同时与两个Device上申请的物理地址绑定。通过aclrtReserveMemAddress接口预留出来的一整段虚拟地址，由用户自行管理、划分时，不能同时与aclrtMallocPhysical、aclrtMemImportFromShareableHandle接口输出的handle绑定。
flags	输入	预留，当前只能设置为0。

返回0表示成功，返回其他值表示失败，请参见aclError。

Atlas 200I/500 A2 推理产品上，Ascend RC形态不支持调用本接口。

父主题： 内存管理