HcclGetCommConfigCapability
产品支持情况
产品 |
是否支持 |
|---|---|
√ |
|
x |
|
x |
|
√ |
|
√ |
|
x |
针对
功能说明
该接口用于判断当前版本软件是否支持某项通信域初始化配置。
通信域初始化时支持的完整配置项可参见HcclCommConfigCapability，包括共享数据的缓存区大小、确定性计算开关、通信域名称、通信算法的编排展开位置等。
使用HcclGetCommConfigCapability接口判断当前软件是否支持某项配置的流程为：
- 调用HcclGetCommConfigCapability接口，获取一个代表当前软件通信域初始化配置能力的数值。
- 比较该数值与HcclCommConfigCapability中某项配置枚举值的大小，若该数值大于枚举值，代表当前软件支持HcclCommConfigCapability中对应枚举值的配置能力；若该数值小于等于枚举值，代表不支持。
例如，若想判断当前软件是否支持配置通信域名称，可使用HcclGetCommConfigCapability接口的返回值与枚举值“HCCL_COMM_CONFIG_COMM_NAME”做比较，若返回值大于“HCCL_COMM_CONFIG_COMM_NAME”，代表当前软件支持配置通信域名称；若返回值小于等于“HCCL_COMM_CONFIG_COMM_NAME”，代表当前软件不支持配置通信域名称。
函数原型
1 | uint32_t HcclGetCommConfigCapability() |
参数说明
无
返回值
uint32_t：表示通信域初始化配置能力的数值。
约束说明
无
调用示例
以下仅为代码片段，不可执行，调用HCCL C接口进行集合通信操作的完整示例可参见样例代码。
1 2 | uint32_t configCapability = HcclGetCommConfigCapability(); bool isSupportCommName = configCapability > HCCL_COMM_CONFIG_COMM_NAME; // 判断是否支持配置通信域名称，需严格大于 |
父主题： 通信域管理