GetThreadPriority (Windows CE 5.0)
This function returns the priority value for the specified thread.
intGetThreadPriority( HANDLEhThread);
Parameters
- hThread
[in] Handle to the thread.
Return Values
The thread's priority level indicates success.
THREAD_PRIORITY_ERROR_RETURN indicates failure.
To get extended error information, call GetLastError.
This function returns the base priority of the thread. If priority inheritance changes the priority of a thread, the value returned by this function might not match the original thread priority or the value assigned by SetThreadPriority.
The following table shows priority level values. The thread's priority level is one of these values.
| Priority level | Description |
|---|---|
| THREAD_PRIORITY_TIME_CRITICAL | Indicates 3 points above normal priority. |
| THREAD_PRIORITY_HIGHEST | Indicates 2 points above normal priority. |
| THREAD_PRIORITY_ABOVE_NORMAL | Indicates 1 point above normal priority. |
| THREAD_PRIORITY_NORMAL | Indicates normal priority (251). |
| THREAD_PRIORITY_BELOW_NORMAL | Indicates 1 point below normal priority. |
| THREAD_PRIORITY_LOWEST | Indicates 2 points below normal priority. |
| THREAD_PRIORITY_ABOVE_IDLE | Indicates 3 points below normal priority. |
| THREAD_PRIORITY_IDLE | Indicates 4 points below normal priority. |
Note Priority levels 0 through 7, available in earlier versions of Windows CE, are now mapped to priority levels 248 through 255.
Remarks
Windows CE does not support priority classes. The order in which threads are scheduled is determined only by their thread priorities.
When manipulating priorities, be sure a high-priority thread does not consume all available CPU time.
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.
**Note **In previous releases, a call to GetThreadPriority or CEGetThreadPriority would return the current thread's priority. The value returned might have been a priority boosted by priority inheritance.
For more information about priority levels in Windows CE, see Priority Levels.
Requirements
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