Add rtems_scheduler_get_maximum_priority()

[Sebastian Huber]

The maximum task priority depends on the scheduler instance. It is a configuration parameter. Add a function to get it at runtime.

/**
 * @brief Gets the maximum task priority of the specified scheduler instance.
 *
 * @param[in] scheduler_id Identifier of the scheduler instance.
 * @param[out] priority Pointer to a task priority value.
 *
 * @retval RTEMS_SUCCESSFUL Successful operation.
 * @retval RTEMS_INVALID_ADDRESS The @a priority parameter is @c NULL.
 * @retval RTEMS_INVALID_ID Invalid scheduler instance identifier.
 */
rtems_status_code rtems_scheduler_get_maximum_priority(
  rtems_id             scheduler_id,
  rtems_task_priority *priority
);

[Sebastian Huber <sebastian.huber@…>]

In 7ee6437/rtems:

rtems: Add rtems_scheduler_get_maximum_priority()

Update #3636.

[Sebastian Huber <sebastian.huber@…>]

In 16f33fd/rtems-docs:

c-user: rtems_scheduler_get_maximum_priority()

Close #3636.