函数：mem_import_by_key

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

在本进程中获取key的信息，并返回本进程可以使用的Device内存地址指针。本接口需与其它接口配合使用，以便实现内存共享的目的，配合使用流程请参见acl.rt.ipc_mem_import_by_key接口处的说明。

C函数原型

aclError aclrtIpcMemImportByKey(void **devPtr, const char *key, uint64_t flag)

python函数

dev_ptr, ret = acl.rt.ipc_mem_import_by_key(key, flags)

参数名	说明
key	str，共享内存key。
flags	是否开启两个Device之间的数据交互。取值为如下宏： ACL_RT_IPC_MEM_IMPORT_FLAG_DEFAULT：默认值，关闭两个Device之间的数据交互。配置为该值时，需单独调用acl.rt.device_enable_peer_access接口开启两个Device之间的数据交互。 ACL_RT_IPC_MEM_IMPORT_FLAG_ENABLE_PEER_ACCESS：开启两个Device之间的数据交互。配置为该值时，则无需调用acl.rt.device_enable_peer_access接口。宏的定义如下： #define ACL_RT_IPC_MEM_IMPORT_FLAG_DEFAULT 0x0UL #define ACL_RT_IPC_MEM_IMPORT_FLAG_ENABLE_PEER_ACCESS 0x1UL

参数名

说明

key

str，共享内存key。

flags

是否开启两个Device之间的数据交互。

取值为如下宏：

ACL_RT_IPC_MEM_IMPORT_FLAG_DEFAULT：默认值，关闭两个Device之间的数据交互。
配置为该值时，需单独调用acl.rt.device_enable_peer_access接口开启两个Device之间的数据交互。
ACL_RT_IPC_MEM_IMPORT_FLAG_ENABLE_PEER_ACCESS：开启两个Device之间的数据交互。
配置为该值时，则无需调用acl.rt.device_enable_peer_access接口。

宏的定义如下：

#define ACL_RT_IPC_MEM_IMPORT_FLAG_DEFAULT            0x0UL
#define ACL_RT_IPC_MEM_IMPORT_FLAG_ENABLE_PEER_ACCESS 0x1UL

返回值	说明
dev_ptr	int，Device内存地址指针。
ret	int，错误码，返回0表示成功，返回其它值表示失败。

父主题： 内存管理