昇腾社区首页
中文
注册

aclrtMemSetPidToShareableHandle

产品支持情况

产品

是否支持

Atlas A3 训练系列产品/Atlas A3 推理系列产品

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

Atlas 200/300/500 推理产品

功能说明

设置可共享内存的进程白名单,只有配置了白名单的进程才能用aclrtMemExportToShareableHandle接口导出的shareableHandle

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

函数原型

aclError aclrtMemSetPidToShareableHandle(uint64_t shareableHandle, int32_t *pid, size_t pidNum)

参数说明

参数名

输入/输出

说明

shareableHandle

输入

通过aclrtMemExportToShareableHandle接口导出的shareableHandle。

pid

输入

用于存放白名单进程ID的数组。

进程ID可调用aclrtDeviceGetBareTgid接口获取,Docker场景下获取到的是物理机上的进程ID,非Docker场景下获取到的是进程ID。

pidNum

输入

白名单进程数量,与pid参数数组的大小保持一致。

返回值说明

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

约束说明

  • Atlas 200I/500 A2 推理产品上,Ascend RC形态不支持调用本接口。
  • 在调用aclrtMemExportToShareableHandle接口的进程中,调用本接口设置进程白名单。