HcclEngineCtxCopy
产品支持情况
产品 |
是否支持 |
|---|---|
√ |
|
√ |
|
☓ |
|
☓ |
|
☓ |
针对
功能说明
指定通信域、通信引擎与通信引擎上下文标签，将Host侧内存数据拷贝至对应的通信引擎上下文中。
函数原型
1 | HcclResult HcclEngineCtxCopy(HcclComm comm, CommEngine engine, const char *ctxTag, const void *srcCtx, uint64_t size, uint64_t dstCtxOffset) |
参数说明
参数名 |
输入/输出 |
描述 |
||
|---|---|---|---|---|
comm |
输入 |
通信域句柄。 HcclComm类型的定义如下：
|
||
engine |
输入 |
通信引擎类型。 |
||
ctxTag |
输入 |
通信引擎上下文标签（最大字符长度为HCCL_RES_TAG_MAX_LEN）。 |
||
srcCtx |
输入 |
源内存地址。 |
||
size |
输入 |
源内存大小。 |
||
dstCtxOffset |
输入 |
拷贝至通信引擎上下文中的地址偏移。 |
返回值
HcclResult：接口成功返回HCCL_SUCCESS，其他失败。
约束说明
无
调用示例
1 2 3 4 5 6 7 | 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); |
父主题： 资源管理