www.beck-ipc.com

@CHIP-RTOS C Library V2.00 - RTOS API


RTX_Get_Task_State

Get state of a task specified by name using the task monitoring mode.

int RTX_Get_Task_State ( const char far *taskname,
                         Task_StateData far *taskdata,
                         int *error );

Parameters

taskname

Input parameter, pointer to 4 character unique name tag of the task whose state information is desired.

taskdata

Output parameter, pointer to a Task_StateData type structure, allocated by the user which will receive data.

error

Output parameter, pointer to 16 bit word to receive error code indicator: 0 on success, else error code.

Return Value

-1 ==> Failure, error code was output to error
Other ==> Task ID

Comments

The task monitoring mode must be enabled in order to use this function.

See Also

RTOS API

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


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


End of document