01.06.2013 Views

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Get state information for a specified task.<br />

Parameters<br />

AH<br />

ES:DI<br />

DS:SI<br />

0x0A (= RTX_GET_TASK_STATE)<br />

Pointer to 4 character unique name tag of the task whose state information is desired. This need not be<br />

a null terminated, but must be four bytes.<br />

Output parameter: Pointer to Task_StateData type structure allocated by the user to be filled by this<br />

API<br />

Return Value<br />

Comments<br />

On Success:<br />

DX = 0<br />

AX = taskID<br />

Task_StateDatastructureat [DS:SI] contains the current task state data<br />

Failure:<br />

DX = -1<br />

IF AX is zero THEN<br />

"Task Monitoringis not enabled".<br />

ELSE<br />

"Specified task not found".<br />

ENDIF<br />

Task monitoring mode must first be enabled in order for this API to work.<br />

The alternative function, RTX_GET_TASK_STATE_EXT, can be used without starting the Task Monitor,<br />

but offers less information about the task.<br />

Related Topics<br />

Top of list<br />

Index page<br />

Task_StateData structure definition<br />

<strong>RTOS</strong> Task Control Services<br />

Start Task Monitor API<br />

Interrupt 0xAD service 0x0B: RTX_GET_TASK_LIST, Get list of tasks<br />

Parameters<br />

AH<br />

Get list of current tasks in the system.<br />

0x0B (= RTX_GET_TASK_LIST)<br />

Page 200 / 400

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!