CeGetThreadPriority

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function gets the priority for a real-time thread.

Syntax

int CeGetThreadPriority(
  HANDLE hThread
);

Parameters

  • hThread
    [in] Handle to a thread.

Return Value

If the function succeeds, it returns the priority of the thread, which is a value from zero through 255. Zero is the highest priority.

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.

Remarks

In previous releases, a call to GetThreadPriority or CeGetThreadPriority returned the priority of the current thread. The value returned might have been a priority boosted by priority inheritance.

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

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Process and Thread Functions
CeSetThreadPriority
SetThreadPriority