---
title: HTL_thread_executor_set_affinity
description: "将执行器绑定到目标CPU列表上。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_ksl_16_0068.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_ksl_16_0068.html
indexId: e0bfe922e1ad9f58d3aedc1de16f85b03071647eeec7a37b51541e77e6fa428e74
---
# HTL_thread_executor_set_affinity

将执行器绑定到目标CPU列表上。

#### 接口定义

int HTL_thread_executor_set_affinity(HTL_thread_executor_t executor, int num_cpuids, int *cpuids);


#### 描述

HTL_thread_executor_set_affinity()用于更新执行器executor绑定的CPU。

- 若num_cpuids大于0，将新执行器executor绑定对应cpuids上。
- 若num_cpuids等于0，将重置执行器executor绑定的CPU。


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| executor | HTL\_thread\_executor\_t | 执行器句柄。 | 输入 |
| num\_cpuids | int | CPU个数。 | 输入 |
| cpuids | int \* | CPU ID。 | 输入 |


#### 返回值

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


#### 示例

```
int *cpuids = (int *)malloc(sizeof(int) * 16);
int i;
for (i = 0; i < 16; i++)
cpuids[i] = i;
HTL_thread_executor_t self_executor;
ret = HTL_thread_executor_self(&self_executor);
ret = HTL_thread_executor_set_affinity(self_executor, 16, cpuids);
```