aclrtMemImportFromShareableHandle

函数功能

在本进程中获取shareableHandle里的信息，并返回本进程中的handle，用于在本进程中建立虚拟地址与物理地址之间的映射关系。本接口还支持生成指定Device上的handle。

本接口需与其它接口配合使用，以便实现内存共享的目的，配合使用流程请参见aclrtMemExportToShareableHandle接口处的说明。

约束说明

• Ascend RC形态不支持调用本接口。
• 在调用本接口前，需确保待共享的物理内存存在，不能提前释放。
• handle与shareableHandle是一一对应的关系，在同一个进程中，不允许一对多、或多对一，否则报错，例如重复调用本接口导入时则会返回报错。
• 不支持同一个进程中调用aclrtMemImportFromShareableHandle、aclrtMemExportToShareableHandle这两个接口，只支持跨进程调用。
• 支持在一个Device上调用aclrtMemExportToShareableHandle接口导出handle，然后调用本接口生成另一个Device上的handle。
• 若调用aclrtFreePhysical销毁handle，则需所有调用本接口的进程都销毁shareableHandle的情况下，handle才会真正销毁。
• 支持跨Device共享物理内存。

  跨Device共享物理内存仅支持如下项，且需配合aclrtDeviceEnablePeerAccess接口使用：

  Atlas 推理系列产品

  Atlas 训练系列产品

  Atlas A2训练系列产品/Atlas 800I A2推理产品

函数原型

aclError aclrtMemImportFromShareableHandle(uint64_t shareableHandle, int32_t deviceId, aclrtDrvMemHandle *handle)

参数说明

返回值说明

返回0表示成功，返回其他值表示失败。