DSAT gate, SET_PRIORITY function
The SET_PRIORITY function of DSAT gate changes the priority of the issuing task, or the task specified by the TASK_TOKEN parameter.
Input Parameters
- PRIORITY
- affects a task's dispatching precedence. It can have a value in the range 0 (low priority) through 255 (high priority).
- SPECIAL_TYPE
- Optional Parameter
- identifies the special task IMMEDIATE_SHUTDOWN_TASK.
- Values for the parameter are:
- IMMEDIATE_SHUTDOWN_TASK
- TASK_TOKEN
- Optional Parameter
- identifies the task whose priority is to be changed.
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- INVALID_TASK_TOKEN
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- OLD_PRIORITY
- Optional Parameter
- is the task's former priority. It can have a value in the range 0 (low priority) through 255 (high priority).