Duration (Pacific Standard Time):
To (Pacific Standard Time):
  • None
User Action:
  • None
Platform Builder for Microsoft Windows CE 5.0

SetThreadPriority (Windows CE 5.0)

Send Feedback

This function sets the priority value for the specified thread.

BOOL SetThreadPriority( 
  HANDLE hThread, 
  int nPriority


[in] Handle to the thread whose priority value is to be set.
[in] Specifies the priority value for the thread.

This parameter can be one of the following values.

THREAD_PRIORITY_TIME_CRITICALIndicates 3 points above normal priority.
THREAD_PRIORITY_HIGHESTIndicates 2 points above normal priority.
THREAD_PRIORITY_ABOVE_NORMALIndicates 1 point above normal priority.
THREAD_PRIORITY_NORMALIndicates normal priority.
THREAD_PRIORITY_BELOW_NORMALIndicates 1 point below normal priority.
THREAD_PRIORITY_LOWESTIndicates 2 points below normal priority.
THREAD_PRIORITY_ABOVE_IDLEIndicates 3 points below normal priority.
THREAD_PRIORITY_IDLEIndicates 4 points below normal priority.
Note   The priority levels 0 through 7 that were available in earlier versions of Windows CE are now mapped to priority levels 248 through 255.

Return Values

Nonzero indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.


Windows CE does not support priority classes. The order in which threads are scheduled is determined only by their thread priorities.

This function enables setting the base priority level of a thread without considering priority classes.

Threads are scheduled in a round-robin fashion at each priority level. Threads at a lower level are only scheduled when no executable threads exist at a higher level.

All threads initially start at THREAD_PRIORITY_NORMAL (251).

Use the GetThreadPriority function to get the priority value of a thread.

Use thread priority values to differentiate the relative priorities of the tasks of a process. For example, a thread that handles input for a window could have a higher priority level than a thread that performs intensive calculations for the CPU.

When manipulating priorities, be sure a high-priority thread does not consume all available CPU time.

For more information about priority levels in Windows CE, see Priority Levels.


OS Versions: Windows CE 1.0 and later.
Header: Winbase.h.
Link Library: Coredll.lib.

See Also


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.