www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Restart_Task

Start a newly created task or restart a killed task.

int RTX_Restart_Task ( int taskID );

Parameters

taskID

Task handle returned from RTX_Create_Task or RTX_Create_Task_Without_Run.

Return Value

0 on success else error code, invalid task ID.

Comments

This function increments a task trigger counter within the specified task's control block.   This trigger counter is then decremented each time the system starts this task.   When a task is at its starting gate and this trigger counter is zero (the initial condition after a task has been created), the task awaits execution with the "trigger wait" status bit in the taskState bit field set.

The RTX_Trigger_Task alias macro provides an alternative name for this function. (This alternate name will be used instead in the C-libraries on future Beck @CHIP-RTOS systems.)

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.00V1.00V1.00V0.90V1.00

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


End of document