CANN/hcomm通信通道销毁

HcommChannelDestroy

【免费下载链接】hcommHCOMM（Huawei Communication）是HCCL的通信基础库，提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm

产品支持情况

• Ascend 950PR/Ascend 950DT：支持
• Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
• Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持

功能说明

该接口为销毁通信通道的资源管理接口，释放由HcommChannelCreate创建的通信通道及其占用的所有系统资源，包括网络连接、同步信号、通信队列等。

该接口支持批量销毁，可在单次调用中释放多个通道，提高资源释放效率。

函数原型

HcommResult HcommChannelDestroy(const ChannelHandle *channels, uint32_t channelNum);

参数说明

返回值

HcommResult：接口成功返回0，其他失败。

约束说明

• channels数组长度需要与channelNum参数一致。
• 对于通过不同引擎创建的通道，可批量销毁。
• 该销毁操作是原子性的，要么全部成功，要么在遇到第一个无效句柄时返回错误。
• 支持的通信协议包括：RoCE、UBC_TP、UBC_CTP、UBoE。

调用示例

EndpointHandle endpointHandle = nullptr; // ... 创建端点的代码（省略） // 创建多个通道 const uint32_t CHANNEL_NUM = 4; HcommChannelDesc channelDescs[CHANNEL_NUM] = {0}; ChannelHandle channels[CHANNEL_NUM] = {0}; // 准备通道描述符并创建通道 for (uint32_t i = 0; i < CHANNEL_NUM; i++) { // ... 填充 channelDescs[i] } HcommResult ret = HcommChannelCreate(endpointHandle, COMM_ENGINE_CPU, channelDescs, CHANNEL_NUM, channels); if (ret != 0) { printf("Failed to create channels, ret = %d\n", ret); HcommEndpointDestroy(endpointHandle); return ret; } printf("%u channels created successfully\n", CHANNEL_NUM); // 使用通道进行通信 // ... // 批量销毁所有通道 ret = HcommChannelDestroy(channels, CHANNEL_NUM); if (ret != 0) { printf("Failed to destroy channels, ret = %d\n", ret); } else { printf("All channels destroyed successfully\n"); } // 销毁端点 HcommEndpointDestroy(endpointHandle);

【免费下载链接】hcommHCOMM（Huawei Communication）是HCCL的通信基础库，提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm