T-Kernel Specification (1.B0.02)

270 CHAPTER 6. T-KERNEL/DS FUNCTIONS
td get reg
Get Task Register
[C Language Interface]
ER ercd = td_get_reg ( ID tskid, T_REGS *pk_regs, T_EIT *pk_eit, T_CREGS *pk_cregs ) ;
[Parameters]
ID tskid Task ID (TSK SELF cannot be designated)
[Return Parameters]
T REGS pk regs General register
T EIT pk eit Registers saved when exception is raised
T CREGS pk cregs Control register
ER ercd Error code
The contents of T REGS, T EIT, and T CREGS are defined for each CPU and implementation.
[Error Codes]
E OK
E ID
E NOEXS
E OBJ
Normal completion
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 (issued for current RUN state task)
[Description]
Gets the register values of the task designated in tskid. This is similar to tk get reg.
Registers cannot be referenced for the task currently in RUN state. Except when a task-independent
portion is executing, the current RUN state task is the invoking task.
When NULL is designated for regs, eit, or cregs, the corresponding register is not referenced.
The contents of T REGS, T EIT, and T CREGS are implementation-dependent.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02