====== OSA : OS_Task_GetPriority ======
<color blue>**char OS_Task_GetPriority (OST_TASK_POINTER tp)**</color>\\ 
=== ===


Returns priority of task.

<note>
Before calling this service you should be sure that variable //tp// was initialized.
</note>

The macro **this_task** or the service ##[[en:osa:ref:allservices:OS_Task_GetCur|OS_Task_GetCur]]##() can be used to perform this operation on the current task.

=== Call allowed: ===
Only in task


=== Parameters: ===
{| class = "fpl"
|-
|//''tp''//
|Pointer to task descriptor (##[[en:osa:ref:description:data_types#OST_TASK_POINTER|OST_TASK_POINTER]]##)
|}

=== Returns: ===
{| class = "fpl"
|-
|//''char''//
| Task priority
|}


=== Example: ===
<code cpp>
void Task (void)
{
    char prio;
    for (;;) {
        /*...*/
        // Increase importance of current task
        prio = OS_Task_GetPriority (this_task);
        if (prio) OS_Task_SetPriority(this_task, --prio);
        /*...*/
    }
}
</code>


=== Old style name ===
<color gray>**OS_GetTaskPriority**</color>\\ 








=== See also ===
  * [[en:osa:ref:allservices:OS_Task_Create|OS_Task_Create]]
  * [[en:osa:ref:allservices:OS_Task_Replace|OS_Task_Replace]]
  * [[en:osa:ref:allservices:OS_Task_Delete|OS_Task_Delete]]
  * [[en:osa:ref:allservices:OS_Task_Define|OS_Task_Define]]

  * [[en:osa:ref:allservices:OS_Task_GetCur|OS_Task_GetCur]]
  * [[en:osa:ref:allservices:OS_Task_GetCreated|OS_Task_GetCreated]]
  * [[en:osa:ref:allservices:OS_Task_Pause|OS_Task_Pause]]
  * [[en:osa:ref:allservices:OS_Task_Continue|OS_Task_Continue]]
  * [[en:osa:ref:allservices:OS_Task_IsPaused|OS_Task_IsPaused]]

  * [[en:osa:ref:allservices:OS_Task_GetPriority|OS_Task_GetPriority]]
  * [[en:osa:ref:allservices:OS_Task_SetPriority|OS_Task_SetPriority]]


----
  * [[en:osa:ref:services:alphabetical|Alphabetical]]
  * [[en:osa:ref:services:brieflist|All services]]
~~UP~~