T-Kernel Specification (1.B0.02)

70 CHAPTER 4. T-KERNEL/OS FUNCTIONS
tk def tex
Define Task Exception Handler
[C Language Interface]
ER ercd = tk_def_tex ( ID tskid, T_DTEX *pk_dtex ) ;
[Parameters]
ID tskid Task ID
T DTEX* pk dtex Task exception handler definition information
pk dtex detail:
ATR texatr Task exception handler attributes
FP texhdr Task exception handler address
(Other implementation-dependent parameters may be added beyond this point.)
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E NOMEM
E ID
E NOEXS
E OBJ
E RSATR
E PAR
Normal completion
Insufficient memory (memory for control block cannot be allocated)
Invalid ID number (tskid is invalid or cannot be used)
Object does not exist (the task designated in tskid does not exist)
Invalid object state (the task designated in tskid runs at protection level 0 (TA RNG0))
Reserved attribute (texatr is invalid or cannot be used)
Parameter error (pk dtex is invalid or cannot be used)
[Description]
Defines a task exception handler for the task designated in tskid. Only one task exception handler can
be defined per task; if one is already defined, the last-defined handler is valid. Setting pk dtex = NULL
cancels a definition.
Defining or canceling a task exception handler clears pending task exception requests and disables all
task exceptions.
The parameter texatr indicates system attributes in is low bits and implementation-dependent attributes
in its high bits. The texatr system attributes are not assigned in the present version, and
system attributes are not used.
A task exception handler takes the following form.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02