![](http://datasheet.mmic.net.cn/260000/PPSMMANUAL_datasheet_15946768/PPSMMANUAL_152.png)
27-4
Task HTask Handling Tools
Programmer’s Manual
Return Value
27.4
TaskCreate
Syntax
STATUS
TaskCreate
(P_U32 taskId P_VOID procAddr S16 xSrc S16 ySrc
S16 xDest S16 yDest, P_U8 bitmap)
Description
PPSM needs to know the existence of each application during initializParameter
stage. The main body of a PPSM system must call this routine once for each
application. PPSM will create the necessary data structure and memory space
required to run the application.
Parameter
Return Value
...
Variable arguments. These are passed to
the sub task routine when the sub task
begins execution
Name
Description
PPSM_OK
Successful operation
PPSM_ERR_NO_MEMORY
Not enough memory
Name
Description
taskId
Returns a task identifier. This identifier is
used by PPSM to refer to the task when it
uses the system resources.
procAddr
Address location of the application
xSrc
Top left x-coordinate of the task icon
ySrc
Top left y-coordinate of the task icon
xDest
Bottom right x-coordinate of the task icon
yDest
Bottom right y-coordinate of the task icon
bitmap
Pointer to bitmap of the task icon
0 - No on-screen icon is needed
Name
Description
PPSM_OK
Successful operation
Name
Description
Personal Portable System Manager
Programmer’s Manual
27-5
27.5
TaskHook
Syntax
STATUS
TaskHook
(U32 taskId, P_VOID entryCallback, P_VOID exitCallback)
Description
Set the entry and exit routines to the specific task. Whenever the task is going
to be swapped in, entryCallback function will be executed. Whenever the task
is going to be swapped out, exitCallback will be executed. The entryCallback
and exitCallback should be function calls with U32 as input parameter and the
function should not involve interrupts, e.g. Entry(U32 oldApp) and Exit(U32
newApp) where oldApp will be the task identifier of the task just swapped out
and newApp will be the next task to be swapped in.
Return Value
27.6
TaskReInit
Syntax
STATUS
TaskReInit
PPSM_ERR_TASK_ID
Invalid task identifier
PPSM_ERR_COORDINATE
Invalid coordinates
PPSM_ERR_NO_MEMORY
Not enough memory
Name
Description
taskId
Task identifier of the task to be hooked
with the entry and exit functions.
entryCallback
The entry function to be executed before
swapping in the task. If NULL is input, no
entry function will be executed.
exitCallback
The exit function to be executed after
swapping out the task. If NULL is input, no
exit function will be executed.
Name
Description
PPSM_OK
Successful Operation
PPSM_ERR_TASK_ID
Invalid task id.
Name
Description
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.