---
title: Initialize
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/hixlug/llmcrv2_42_41.html
sourcePath: /source/zh/canncommercial/900/API/hixlug/llmcrv2_42_41.html
indexId: 6db62b966306de8b313e7eeca5db945661e094cf0d9cfb8a5c75eb5052c0942359
---
# Initialize

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | x |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | x |
| Atlas 推理系列产品 | x |
| Atlas 训练系列产品 | x |


说明：针对 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，仅支持Atlas 800I A2 推理服务器、A200I A2 Box 异构组件。


#### 函数功能

初始化AdxlEngine，在调用其他接口前需要先调用该接口。


#### 函数原型

```
Status Initialize(const AscendString &local_engine, const std::map<AscendString, AscendString> &options)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| local\_engine | 输入 | AdxlEngine标识，在所有参与建链的范围内需要确保唯一。格式为host\_ip:host\_port或host\_ip，不建议配置为回环IP，在多个AdxlEngine交互场景，回环IP容易冲突。 当设置host\_port且host\_port>0时， 则当前AdxlEngine作为Server端需要对配置端口进行侦听。如果没设置host\_port或者host\_port<=0代表是Client，不启动侦听。 |
| options | 输入 | 初始化参数值。具体请参考表1。 |


**表1 options**

| 参数名 | 可选/必选 | 描述 |
| --- | --- | --- |
| OPTION\_BUFFER\_POOL | 可选 | 字符串取值"BufferPool"。 在需要使用中转buffer进行传输的场景下: 不支持使用HCCS协议进行Host To Host直传传输时。 RDMA注册Host内存大小受限时。 多个小块内存传输(例如128K)需要使用中转传输提升性能时。 可使用此option配置中转内存池的大小，取值格式为"$BUFFER\_NUM:$BUFFER\_SIZE"，系统默认会配置为"4:8(单位MB)"，可以通过配置为"0:0"来关闭中转内存池，在有并发的场景下建议增大$BUFFER\_NUM个数, 另外，所有使用的地方需要配置相同的值，中转传输模式的限制请参考TransferSync章节。 |
| OPTION\_RDMA\_TRAFFIC\_CLASS | 可选 | 字符串取值"RdmaTrafficClass"。 用于配置RDMA网卡的traffic class。和环境变量HCCL\_RDMA\_TC功能，如同时配置，当前option优先级更高；未同时配置，以配置的一方为准。 取值范围为[0,255]，且需要配置为4的整数倍，默认值为132。 更多信息请参考《环境变量参考(https://www.hiascend.com/document/detail/zh/canncommercial/900/maintenref/envvar/envref\_07\_0001.html)》。 |
| OPTION\_RDMA\_SERVICE\_LEVEL | 可选 | 字符串取值"RdmaServiceLevel"。 用于配置RDMA网卡的service level。和环境变量HCCL\_RDMA\_SL功能相同，如同时配置，当前option优先级更高；未同时配置，以配置的一方为准。 取值范围为[0, 7]，默认值为4。 更多信息请参考《环境变量参考(https://www.hiascend.com/document/detail/zh/canncommercial/900/maintenref/envvar/envref\_07\_0001.html)》。 |


#### 调用示例

单击Gitee(https://gitee.com/ascend/samples/tags)，根据“标签名”下载配套版本的sample包，从“cplusplus/level1_single_api/12_adxl”目录中获取样例。


#### 返回值

- SUCCESS：成功
- PARAM_INVALID：参数错误
- 其他：失败


#### 异常处理

无


#### 约束说明

1. 需要和  Finalize
配对使用，初始化成功后，任何退出前都需要先调用  Finalize
保证资源释放，否则会出现资源释放顺序不符合预期而导致问题。
2. 初始化前需要先调用“aclrtSetDevice(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_0039.html)”。