HcommBatchModeStart

产品支持情况

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

功能说明

该接口用于开启批量模式，在HcommBatchModeStart和HcommBatchModeEnd之间的所有数据面接口调用（如 HcommLocalCopy、HcommWrite 等）将被缓存，不会立即执行。所有操作将在调用HcommBatchModeEnd时统一提交并执行。

函数原型

1

int32_t HcommBatchModeStart(const char *batchTag)

参数说明

返回值

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

约束说明

1. HcommBatchModeStart和HcommBatchModeEnd必须成对调用，且需在同一线程中执行。
2. 批量模式下缓存的操作需在HcommBatchModeEnd调用后才会实际执行。

调用示例

1
2
3
4
5
6
7
8
9

char *tag = "";
// 启动批量模式（临时批量任务）
HcommBatchModeStart(tag);

// 在批量模式中调用数据面接口不会立即执行
// ...

// 结束批量模式并触发执行
HcommBatchModeEnd(tag);