---
title: SetCommEngine
description: "设置通信任务使用的通信引擎。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_10399.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_10399.html
indexId: 858461f776ba688d0416a01f5321ed8380f2fbb279cd0269ba0918f8df5e6a6277
---
# SetCommEngine

#### 功能说明

设置通信任务使用的通信引擎。


#### 函数原型

```
uint32_t SetCommEngine(uint8_t commEngine)
```


#### 参数说明


**表1 参数说明**

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| commEngine | 输入 | 通信引擎。uint8\_t类型，该参数的取值范围请参考：hcclOpExpansionMode(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/hcclug/hcclcpp\_07\_0047.html\#ZH\-CN\_TOPIC\_0000002531530198\_\_li148565015718)。 |


#### 返回值说明

- 0表示设置成功。
- 非0表示设置失败。


#### 约束说明

无


#### 调用示例

```
static ge::graphStatus AllToAllVCustomTilingFunc(gert::TilingContext *context)
{
    AllToAllVCustomV3TilingData *tiling = context->GetTilingData<AllToAllVCustomV3TilingData>();
    const std::string groupName = "testGroup";
    const std::string algConfig = "AlltoAll=level0:fullmesh;level1:pairwise";
    AscendC::Mc2CcTilingConfig mc2CcTilingConfig(groupName, HCCL_CMD_ALLTOALLV, algConfig, 0);
    mc2CcTilingConfig.SetCommEngine(1U);
    mc2CcTilingConfig.GetTiling(tiling->mc2InitTiling);
    mc2CcTilingConfig.GetTiling(tiling->mc2CcTiling);
    return ge::GRAPH_SUCCESS;
}
```