# OS_SetThreadPriority

## C Specification

      #include <nitro/os.h>

      BOOL OS_SetThreadPriority( OSThread* thread, u32 prio );

## Arguments

thread | A pointer to the thread you want to prioritize.
prio | The priority level you want to set (0-31).

## Return Values

Returns TRUE if priority setting succeeded. Returns TRUE even if you set to the same priority as the original. Returns FALSE if there is no thread.

## Description

This function sets thread priority. Thread priorities range from 0 to 31. Threads that have a priority level of 0 have the highest priority. If thread priorities change, scheduling might also change.

The thread system creates an idle thread (priority 32) during `OS_InitThread()`, but its priority cannot be changed.

## See Also

`OS_InitThread, OS_GetThreadPriority`

## Revision History

04/27/2004 Added note about idle thread.
02/26/2004 Initial version

CONFIDENTIAL