T-Kernel Specification (1.B0.02)

6.1. KERNEL INTERNAL STATE ACQUISITION FUNCTIONS 271
td set reg
Set Task Register
[C Language Interface]
ER ercd = td_set_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)
T REGS pk regs General registers
T EIT pk eit Registers saved when exception is raised
T CREGS pk cregs Control registers
The contents of T REGS, T EIT, and T CREGS are defined for each CPU and implementation.
[Return Parameters]
ER ercd Error code
[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]
Sets registers of the task designated in tskid. This is similar to tk set reg.
Registers cannot be set 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 set.
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