---
title: kupl_sgraph_add_node
description: "向kupl静态图中添加 sgraph node节点，即添加任务节点。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_044.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_044.html
indexId: 647aa139d1daef9fc3b3276a9d736861df230fc376688b3164dc87d8c9307c5d67
---
# kupl_sgraph_add_node

向kupl静态图中添加 sgraph node节点，即添加任务节点。

#### 接口定义


kupl_sgraph_node_h kupl_sgraph_add_node(kupl_sgraph_h sgraph, kupl_sgraph_node_desc_t *desc);


#### 参数


**表1 参数定义**

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| sgraph | kupl\_sgraph\_h | 需要向其中添加sgraph node的静态图 | 输入/输出 |
| desc | kupl\_sgraph\_node\_desc\_t \* | 需要添加的sgraph node的描述，具体见下表 | 输入 |


**表2 kupl_sgraph_node_desc_t的数据结构**

| 参数名 | 类型 | 描述 |
| --- | --- | --- |
| field\_mask | uint64\_t | 掩码，用于指定结构体中哪些值有效，不设置掩码情况下仅func、args参数生效，其他需要设置掩码。 具体可设置的掩码： KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_NAME: name生效 KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_PRIORITY: priority生效 KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_FLAG: flag生效 KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_EGROUP: egroup生效 |
| func | kupl\_sgraph\_node\_func\_t | sgraph node节点的函数，该节点提交执行后需要执行的具体函数 |
| args | void \* | func函数需要传入的参数 |
| name | const char \* | 需要配置掩码KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_NAME后才能生效；该节点的名字 |
| priority | int | 需要配置掩码KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_PRIORITY后才能生效；该节点的优先级，数值越大，优先级越高 |
| flag | uint32\_t | 需要配置掩码 KUPL\_SGRAPH\_NODE\_DESC\_FIELD\_FLAG后才能生效；该节点的flag，可设置为 KUPL\_SGRAPH\_NODE\_FLAG\_IMM，表示提交后将直接执行该节点 |
| egroup | kupl\_egroup\_h | 指定当前sgraph node的亲和性信息 |


#### 返回值

- 成功：返回添加的 sgraph node节点
- 失败：返回nullptr


#### 示例

```
#include <stdio.h> 
#include "kupl.h" 

static inline void task_str(void *args)
{
    printf("static graph task test.\n");
}

int main() 
{ 
    kupl_graph_h graph = kupl_graph_create(nullptr);

    kupl_sgraph_h sgraph = kupl_sgraph_create();
    kupl_sgraph_node_desc_t node_desc = {
        .func = task_str,
        .args = NULL,
    };
    kupl_sgraph_node_h node = kupl_sgraph_add_node(sgraph, &node_desc);

    kupl_sgraph_task_desc_t task_desc = {
        .sgraph = sgraph,
    };
    kupl_task_info_t info = {
        .type = KUPL_TASK_TYPE_SGRAPH,
        .desc = &task_desc,
    };
    kupl_graph_submit(graph, &info);

    kupl_graph_wait(graph);
    kupl_graph_destroy(graph);
    kupl_sgraph_destroy(sgraph);
    return 0;         
}
```

运行结果如下。
```
static graph task test.
```

上述示例演示了在静态图中添加gnode，并通过提交静态图执行的流程。上述 kupl_sgraph_add_node 函数向静态图sgraph中添加了sgraph node节点，该sgraph node节点的函数为task_str，函数不需要参数。