SetThreadPriorityBoost 函数 (processthreadsapi.h)

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

语法

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

参数

[in] hThread

要提升其优先级的线程的句柄。 句柄必须具有 THREAD_SET_INFORMATIONTHREAD_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

另请参阅

GetThreadPriorityBoost

OpenThread

优先级提升

进程和线程函数

计划优先级

线程