---
title: HTL_thread_executor_get_affinity
description: "获取执行器绑定的目标CPU列表。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_ksl_16_0069.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_ksl_16_0069.html
indexId: c01e73853e4aad6bfa3bfe1581b87618c2e2d69f7e3eb9b272511bcaab7d902174
---
# HTL_thread_executor_get_affinity

获取执行器绑定的目标CPU列表。

#### 接口定义

int HTL_thread_executor_get_affinity(HTL_thread_executor_t executor, int max_cpuids, int *cpuids, int *num_cpuids);


#### 描述

HTL_thread_executor_get_affinity()用于获取执行器绑定的目标CPU列表。若执行器未绑定任何CPU，cpuids不会被更新。


#### 参数

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


#### 返回值

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


#### 示例

```
cpuset_size = num_cpus;
cpuset = (int *)malloc(cpuset_size * sizeof(int));
num_cpus = 0;
HTL_thread_executor_t self_executor;
ret = HTL_self_get_xstream(&self_executor);
ret = HTL_thread_executor_get_affinity(self_executor, cpuset_size, cpuset, &num_cpus);
```