SetThreadPriorityBoost 函数 (processthreadsapi.h)

项目
03/01/2024

禁用或启用系统暂时提升线程优先级的功能。

语法

BOOL SetThreadPriorityBoost(
  [in] HANDLE hThread,
  [in] BOOL   bDisablePriorityBoost
);

参数

[in] hThread

要提升其优先级的线程的句柄。句柄必须具有 THREAD_SET_INFORMATION 或 THREAD_SET_LIMITED_INFORMATION 访问权限。有关详细信息，请参阅线程安全和访问权限。

Windows Server 2003 和 Windows XP： 句柄必须具有 THREAD_SET_INFORMATION 访问权限。

[in] bDisablePriorityBoost

如果此参数为 TRUE，则禁用动态提升。如果参数为 FALSE，则启用动态提升。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

当某个线程在其中一个动态优先级类中运行时，当线程退出等待状态时，系统会暂时提升该线程的优先级。如果在 DisablePriorityBoost 参数设置为 TRUE 的情况下调用 SetThreadPriorityBoost，则不会提升线程的优先级。若要还原正常行为，请调用 SetThreadPriorityBoost， 将 DisablePriorityBoost 设置为 FALSE。

要求

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