GetThreadPriorityBoost

The GetThreadPriorityBoost function retrieves the priority boost control state of the specified thread.

BOOL GetThreadPriorityBoost(
  HANDLE hThread,              // handle to thread
  PBOOL pDisablePriorityBoost  // priority boost state
);

Parameters

hThread

[in] Handle to the thread. This thread must have THREAD_QUERY_INFORMATION access. For more information, see Thread Security and Access Rights.

pDisablePriorityBoost

[out] Pointer to a variable that receives the priority boost control state. A value of TRUE indicates that dynamic boosting is disabled. A value of FALSE indicates normal behavior.

Return Values

If the function succeeds, the return value is nonzero. In that case, the variable pointed to by the pDisablePriorityBoost parameter receives the priority boost control state.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

Processes and Threads Overview, Process and Thread Functions, OpenThread, SetThreadPriorityBoost