td_set_reg

Set Task Register

See Also

[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 specified)


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	Normal completion


E_ID	Invalid ID number (tskid is invalid or cannot be used)


E_NOEXS	Object does not exist (the task designated in tskid does not exist)


E_OBJ	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 pk_regs, pk_eit, or pk_cregs, the corresponding register is not set.

The contents of T_REGS, T_EIT, and T_CREGS are implementation-dependent.

Comments

Click here to Post a Comment