GeSessionLoadGraph

Description

Binds the graph with the specified graph ID to the corresponding stream using a specified session. After GeSessionLoadGraph is successfully executed, the GeSessionExecuteGraphWithStreamAsync API can be used to execute the graph. This API is used only in the asynchronous graph execution scenario.

Prototype

ge::Status GeSessionLoadGraph(ge::Session &session, uint32_t graph_id, const std::map<ge::AscendString, ge::AscendString> &options, void *stream);

Parameters

Parameter

Input/Output

Description

session

Input

Session instance of the graph to be loaded.

graph_id

Input

ID of the graph to be run.

options

Input

Option that may be used in the execution phase. A key-value mapping table, for the graph configuration. key indicates the option type, and value indicates the option value.

Generally, this parameter can be left empty, indicating using the same options configuration passed to GEInitialize.

The key and value are of the AscendString type. You can use this parameter to configure the current graph separately. For details about the supported configuration options, see Command-Line Options > ge.exec.frozenInputIndexes. Currently, only this parameter can be configured.

stream

Input

Graph execution flow.

Returns

Parameter

Type

Description

-

Status

GE_CLI_SESS_RUN_FAILED: Serialization failed when a subgraph is executed.

SUCCESS: Subgraph executed successfully.

FAILED: Failed to execute the subgraph.

Restrictions

Before calling this API, ensure that the CompileGraph process has been completed and the API must be used together with GeSessionExecuteGraphWithStreamAsync.