---
title: HTL_thread_setaffinity_np
description: "设置线程亲和性。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_ksl_16_0102.html
sourcePath: /source/zh/kunpengboostkithistory/251RC1/accel/kunpengaccel_ksl_16_0102.html
indexId: 137c28911aacc924894775c8904379a0768ba53f6216c39b35e05d80e974d08f76
---
# HTL_thread_setaffinity_np

设置线程亲和性。

#### 接口定义

int HTL_thread_setaffinity_np(HTL_thread_t *thread, size_t cpu_set_size, const cpu_set_t *cpuset);


#### 描述

HTL_thread_setaffinity_np()用于设置线程的CPU亲和性，将线程thread绑定到特定CPU合集cpuset上，由cpu_set_size指定CPU合集大小（以字节为单位）。

当前仅支持设置目标CPU合集在当前执行器运行的CPU合集范围内，若线程设置的目标CPU合集与关联的执行器相同，则会返回HTL_THREAD_ERR_MIGRATION_TARGET。


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| thread | HTL\_thread\_t \* | 线程句柄的地址。 | 输入 |
| cpu\_set\_size | size\_t | CPU合集大小。 | 输入 |
| cpuset | cpu\_set\_t \* | CPU合集。 | 输入 |


#### 返回值

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


#### 示例

```
int status = HTL_thread_setaffinity_np(thread, sizeof(cpu_set_t), &cpu_set);
```