---
title: HTL_thread_barrier_init
description: "初始化屏障。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_ksl_16_0131.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_ksl_16_0131.html
indexId: 31e71e2f93662ce4b46ba193c9213466da2d07b1077983d93ea19773c9a8823b76
---
# HTL_thread_barrier_init

初始化屏障。

#### 接口定义

int HTL_thread_barrier_init(HTL_thread_barrier_t *thread_barrier, HTL_thread_barrierattr_t *thread_barrierattr, uint32_t waiters);


#### 描述

HTL_thread_barrier_init()用于根据屏障属性thread_barrierattr初始化一个障碍，并通过thread_barrier返回其句柄，waiters用于指定等待者的数量，waiters必须大于零。

障碍thread_barrier使用完后，需使用函数HTL_thread_barrier_destroy()销毁。

屏障属性仅支持设置NULL。


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| thread\_barrier | HTL\_thread\_barrier\_t \* | 屏障句柄地址。 | 输出 |
| thread\_barrierattr | HTL\_thread\_barrierattr\_t \* | 屏障属性句柄地址。 | 输入 |
| waiters | uint32\_t | 等待者的数量。 | 输入 |


#### 返回值

- HTL_THREAD_SUCCESS：成功。
- 其他：失败。见错误码定义。


#### 示例

```
HTL_thread_barrier_t barrier;
    HTL_thread_barrier_init(&barrier, NULL, waiters);
```