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

#### 产品支持情况

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


#### 头文件/库文件

- 头文件：#include <ge/ge_api.h>
- 库文件：libge_runner.so


#### 功能说明

异步执行Graph场景使用，将指定Graph ID的图绑定到对应Stream上。

该接口执行前需要完成CompileGraph流程，且LoadGraph成功后需要使用ExecuteGraphWithStreamAsync接口执行图。


#### 函数原型

```
Status LoadGraph(const uint32_t graph_id, const std::map<AscendString, AscendString> &options, void *stream) const
```


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| graph\_id | 输入 | 要执行Graph对应的ID。 |
| options | 输入 | 执行阶段可能用到的options。map表，key为参数类型，value为参数值，描述Graph配置信息。 一般情况下可不填，与GEInitialize传入的全局options保持一致。 key和value类型为AscendString，如需单独配置当前Graph的配置信息时，可以通过此参数配置，支持的配置项请参见options参数说明>ge.exec.frozenInputIndexes和ge.exec.hostInputIndexes，当前只支持配置上述两个参数。 |
| stream（异步执行Graph场景） | 输入 | Graph执行流。 |


#### 返回值说明

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| \- | Status | GE\_CLI\_SESS\_RUN\_FAILED：执行子图时序列化转换失败。 SUCCESS：执行子图成功。 FAILED：执行子图失败。 |


#### 约束说明

通过LoadGraph加载的Stream，和通过ExecuteGraphWithStreamAsync接口运行时使用的Stream，推荐是同一条Stream，如果不是同一条Stream，需要在LoadGraph后，对加载使用的Stream调用流同步接口“aclrtSynchronizeStream(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/runtimeapi/aclcppdevg_03_0076.html)”完成同步。