[RTEMS Project] #2784: Add function to get the current priority of a task by scheduler instance

[RTEMS trac]

#2784: Add function to get the current priority of a task by scheduler instance
-----------------------------+-----------------------------
 Reporter:  sebastian.huber  |      Owner:  sebastian.huber
     Type:  enhancement      |     Status:  new
 Priority:  normal           |  Milestone:  4.12
Component:  SMP              |    Version:  4.12
 Severity:  normal           |   Keywords:
-----------------------------+-----------------------------
 {{{
 /**
  * @brief Gets the current priority of the specified task with respect to
 the
  * specified scheduler instance.
  *
  * The current priority reflects temporary priority adjustments due to
 locking
  * protocols, the rate-monotonic objects on some schedulers and other
  * mechnisms.
  *
  * @param[in] task_id Identifier of the task.  Use @ref RTEMS_SELF to
 select
  *   the executing task.
  * @param[in] scheduler_id Identifier of the scheduler instance.
  * @param[out] priority Returns the current priority of the specified task
 with
  *   respect to the specified scheduler instance.
  *
  * @retval RTEMS_SUCCESSFUL Successful operation.
  * @retval RTEMS_ILLEGAL_ON_REMOTE_OBJECT Directive is illegal on remote
 tasks.
  * @retval RTEMS_INVALID_ADDRESS The priority parameter is @c NULL.
  * @retval RTEMS_INVALID_ID Invalid task or scheduler identifier.
  * @retval RTEMS_NOT_DEFINED The task has no priority within the specified
  *   scheduler instance.
  *
  * @see rtems_scheduler_ident().
  */
 rtems_status_code rtems_task_get_priority(
   rtems_id             task_id,
   rtems_id             scheduler_id,
   rtems_task_priority *priority
 );
 }}}

--
Ticket URL: <http://devel.rtems.org/ticket/2784>
RTEMS Project <http://www.rtems.org/>
RTEMS Project