---
title: HTL_thread_executor_get_affinity
description: "获取执行器绑定的目标CPU列表。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengaccel/system-lib/htl/kunpengaccel_ksl_16_0069.html
sourcePath: /source/zh/kunpengaccel/system-lib/htl/kunpengaccel_ksl_16_0069.html
indexId: 2daca7a0a3dab639e57278f549fe276ed0763389b13bee366dec142b603b6d1668
---
# 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);
```