---
title: HTL_thread_executor_set_affinity
description: "将执行器绑定到目标CPU列表上。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/htl/kunpengaccel_ksl_16_0068.html
sourcePath: /source/zh/kunpengaccel/system-lib/htl/kunpengaccel_ksl_16_0068.html
indexId: 0d66a6c1a677b4f772304f5cedc9ab246d51419d4d76f733bd8307565bb3a36068
---
# 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);
```