setThreadIdealProcessor 函数 (processthreadsapi.h)

项目
08/25/2023

设置线程的首选处理器。系统尽可能在其首选处理器上计划线程。

在处理器超过 64 的系统上，此函数将首选处理器设置为调用线程分配到的处理器组中的逻辑处理器。使用 SetThreadIdealProcessorEx 函数指定处理器组和首选处理器。

语法

DWORD SetThreadIdealProcessor(
  [in] HANDLE hThread,
  [in] DWORD  dwIdealProcessor
);

参数

[in] hThread

要设置其首选处理器的线程的句柄。句柄必须具有THREAD_SET_INFORMATION访问权限。有关详细信息，请参阅线程安全和访问权限。

[in] dwIdealProcessor

线程的首选处理器数。此值从零开始。如果此参数MAXIMUM_PROCESSORS，则函数返回当前的理想处理器而不对其进行更改。

返回值

如果函数成功，则返回值为上一个首选处理器。

如果函数失败，则返回值 (DWORD) - 1。要获得更多的错误信息，请调用 GetLastError。

注解

可以使用 GetSystemInfo 函数确定计算机上的处理器数。还可以使用 GetProcessAffinityMask 函数检查允许运行线程的处理器。请注意， GetProcessAffinityMask 返回位掩码，而 SetThreadIdealProcessor 使用整数值来表示处理器。

从 Windows 11 和 Windows Server 2022 开始，在处理器数超过 64 的系统上，默认情况下，进程和线程相关性跨所有处理器组跨系统中的所有处理器。 SetThreadIdealProcessor 函数将首选处理器设置为线程主组中的逻辑处理器。

若要编译使用此函数的应用程序，请将_WIN32_WINNT定义为 0x0400 或更高版本。有关详细信息，请参阅使用 Windows 标头。

Windows 8.1和Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	processthreadsapi.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll