昇腾社区首页
中文
注册
开发者
下载

HcclCommGetHandleWithName

产品支持情况

产品

是否支持

Atlas 350 加速卡

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

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

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

功能说明

根据通信域名称获取指向对应通信域的句柄。

函数原型

1
HcclResult HcclCommGetHandleWithName(const char* commName, HcclComm* comm)

参数说明

参数名

输入/输出

说明

commName

输入

通信域名称。

const char*类型,最大长度支持128。

comm

输出

获取到的对应通信域句柄。

HcclComm类型的定义可参见HcclComm

返回值

HcclResult:接口成功返回HCCL_SUCCESS,其他失败。

约束说明

调用示例

1
2
3
4
5
// 定义需要获取通信域句柄的通信域名称
char commName[128] = "group_name_0";
HcclComm comm;
// 获取通信域名称对应的通信域句柄
HcclCommGetHandleWithName(commName, &comm);