--- title: 函数：mem_import_from_shareable_handle description: "| 产品 | 是否支持 |" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0959.html sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0959.html indexId: 4ad6363035856533f5fa6ca1739c091ccef84340a90d22c036b1126e3cf1975771 --- # 函数：mem_import_from_shareable_handle #### 产品支持情况 | 产品 | 是否支持 | | --- | --- | | Atlas 350 加速卡 | √ | | Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ | | Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ | | Atlas 训练系列产品 | √ | | Atlas 推理系列产品 | √ | | Atlas 200I/500 A2 推理产品 | √ | #### 功能说明 在本进程中获取shareable_handle里的信息，并返回本进程中的handle，用于在本进程中建立虚拟地址与物理地址之间的映射关系。本接口还支持生成指定Device上的handle。 本接口需与其它接口配合使用，以便实现内存共享的目的，配合使用流程请参见acl.rt.mem_export_to_shareable_handle接口处的说明。 #### 函数原型 - C函数原型 1 aclError aclrtMemImportFromShareableHandle(uint64_t shareableHandle, int32_t deviceId, aclrtDrvMemHandle *handle) - python函数 1 handle, ret = acl.rt.mem_import_from_shareable_handle(shareable_handle, device_id) #### 参数说明 | 参数名 | 说明 | | --- | --- | | shareable\_handle | int，待共享的shareable\_handle。 与acl.rt.mem\_export\_to\_shareable\_handle接口中导出的shareable\_handle保持一致。 | | deviceId | int，用于生成指定Device ID上的handle。 用户调用acl.rt.get\_device\_count接口获取可用的Device数量后，这个Device ID的取值范围：[0, (可用的Device数量 \- 1)] | #### 返回值说明 | 返回值 | 说明 | | --- | --- | | handle | int，本进程的物理内存handle。 | | ret | int，错误码，返回0表示成功，返回其它值表示失败。 | #### 约束说明 - Atlas 200I/500 A2 推理产品上，Ascend RC形态不支持调用本接口。 - 在调用本接口前，需确保待共享的物理内存存在，不能提前释放。 - handle与shareableHandle是一一对应的关系，在同一个进程中，不允许一对多、或多对一。 - 不支持同一个进程中调用 acl.rt.mem_import_from_shareable_handle 、 acl.rt.mem_export_to_shareable_handle 这两个接口，只支持跨进程调用。 - 支持在一个Device上调用 acl.rt.mem_export_to_shareable_handle 接口导出handle，然后调用本接口生成另一个Device上的handle。 - 内存使用完成后，要及时调用 acl.rt.free_physical 销毁handle，并且需所有调用本接口的进程都销毁shareable_handle的情况下，handle才会真正销毁。 - 支持跨Device共享物理内存。 跨Device共享物理内存仅支持如下型号，且需配合acl.rt.device_enable_peer_access接口使用： Atlas A3 训练系列产品 / Atlas A3 推理系列产品 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 Atlas 训练系列产品 Atlas 推理系列产品