---
title: aclrtMemP2PMap
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclcppdevg_03_2162.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_2162.html
indexId: 04dcf6a60ecedd7cc7e493f44c286046f0a356bdc8816e5a0bdf7bfae04effc268
---
# aclrtMemP2PMap

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | ☓ |
| Atlas 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |


#### 功能说明

本接口用于建立同一进程内两个Device之间的内存页表映射，以实现跨Device的内存访问，但在进行此操作前，需先调用aclrtDeviceEnablePeerAccess接口以开启两个Device间的数据交互。

调用本接口建立页表映射后，跨Device访问时不会出现内存缺页的问题，首次访问内存时性能更优。


#### 函数原型

```
aclError aclrtMemP2PMap(void *devPtr, size_t size, int32_t dstDevId, uint64_t flags)
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| devPtr | 输入 | Device内存地址（例如调用aclrtMalloc接口申请的Device内存），此处指共享内存提供方的内存地址。 |
| size | 输入 | 内存大小，单位Byte。 |
| dstDevId | 输入 | Device ID，此处指共享内存使用方的ID。 |
| flags | 输入 | 预留参数，当前固定设置为0。 |


#### 返回值说明

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