www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Change_TaskPrio

Change specified task's priority.

int RTX_Change_TaskPrio ( int taskID, int priority,
                          int *error );

This function is deprecated! Use RTX_Task_Priority instead.

Parameters

taskID

Task handle returned from RTX_Create_Task or RTX_Create_Task_Without_Run.
Set to zero for current task.

priority

Task priority in range 2...127 where priority 2 is high and 127 is low.

error

Output Parameter:   Pointer to error variable

Return Value

0, success.
non-zero --> Variable error contains error code.

Comments

The calling tasks' priority can be adjusted by setting the taskID parameter to zero.   The AMXK kernel task's priority cannot be changed.

An out of range priority value will be limited to range 2..127 inside this function.   (An exception is the value 0x5ABC for which no operation will be performed.)

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Related Topics

RTX API   Overview

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.20V1.20V1.20V1.05V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document