CANN/hcomm引擎上下文复制

📅 2026/7/15 20:25:17 👁️ 阅读次数 📝 编程学习
CANN/hcomm引擎上下文复制

HcclEngineCtxCopy

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

产品支持情况

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

[!NOTE]说明 针对Atlas A2 训练系列产品/Atlas A2 推理系列产品,仅支持Atlas 800T A2 训练服务器、Atlas 900 A2 PoD 集群基础单元、Atlas 200T A2 Box16 异构子框。

功能说明

指定通信域、通信引擎与通信引擎上下文标签,将Host侧内存数据拷贝至对应的通信引擎上下文中。

函数原型

HcclResult HcclEngineCtxCopy(HcclComm comm, CommEngine engine, const char *ctxTag, const void *srcCtx, uint64_t size, uint64_t dstCtxOffset)

参数说明

参数名输入/输出描述
comm输入通信域句柄。
HcclComm类型的定义如下:
typedef void *HcclComm;
engine输入通信引擎类型。
ctxTag输入通信引擎上下文标签(最大字符长度为HCCL_RES_TAG_MAX_LEN)。
srcCtx输入源内存地址。
size输入源内存大小。
dstCtxOffset输入拷贝至通信引擎上下文中的地址偏移。

返回值

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

约束说明

调用示例

HcclComm comm; CommEngine engine = CommEngine::COMM_ENGINE_AICPU_TS; string ctxTag = "ctxTag"; AlgResourceCtx* resCtx; // 有效的源ctx uint64_t size = 16; // 需要拷贝的实际大小 uint64_t dstCtxOffset = 0; // 全部拷贝情况下,偏移传0 ret = HcclEngineCtxCopy(comm, engine, ctxTag, resCtx, size, dstCtxOffset);

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考