HcclGetCommConfigCapability

功能说明

该接口用于判断当前版本软件是否支持某项通信域初始化配置。

通信域初始化时支持的完整配置项可参见HcclCommConfigCapability，包括共享数据的缓存区大小、确定性计算开关、通信域名称等。

使用HcclGetCommConfigCapability接口判断当前软件是否支持某项配置的流程为：
  1. 调用HcclGetCommConfigCapability接口，获取一个代表当前软件通信域初始化配置能力的数值。
  2. 比较该数值与HcclCommConfigCapability中某项配置枚举值的大小，若该数值大于枚举值，代表当前软件支持HcclCommConfigCapability中对应枚举值的配置能力；若该数值小于等于枚举值，代表不支持。

    例如，若想判断当前软件是否支持配置通信域名称，可使用HcclGetCommConfigCapability接口的返回值与枚举值“HCCL_COMM_CONFIG_COMM_NAME”做比较，若返回值大于“HCCL_COMM_CONFIG_COMM_NAME”，代表当前软件支持配置通信域名称；若返回值小于等于“HCCL_COMM_CONFIG_COMM_NAME”，代表当前软件不支持配置通信域名称。

函数原型

uint32_t HcclGetCommConfigCapability()

参数说明

无

返回值

uint32_t：表示通信域初始化配置能力的数值。

约束说明

无

支持的型号

Atlas 训练系列产品

Atlas A2 训练系列产品

Atlas 300I Duo 推理卡

调用示例

1
2
uint32_t configCapability = HcclGetCommConfigCapability();
bool isSupportCommName = configCapability > HCCL_COMM_CONFIG_COMM_NAME;  // 判断是否支持配置通信域名称，需严格大于
父主题： 通信域管理