tk_set_cpr

Set Task Co-processor Registers

[C Language Interface]

ER ercd = tk_set_cpr ( ID tskid, INT copno, T_COPREGS *pk_copregs ) ;

[Parameters]

ID tskid Task ID

INT copno Co-processor number (0 to 3)

T_COPREGS pk copregs Co-processor registers

[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 specified in tskid does not exist)

E_OBJ Invalid object state (called for the invoking task)

E_CTX Context error (called from task-independent portion)

E_PAR Parameter error (copno is invalid or the specified co-processor does not exist), or the set register value is invalid (implementation-dependent)

[Description]

Sets the contents of the register specified in copno of the task specified in tskid.

The set register values are not necessarily the values while the task portion is executing. The OS is not aware of the e.ects of register value changes. It is possible, however, that some registers or register bits cannot be changed if the OS does not allow such changes (implementation-dependent).

If this system call is issued for the invoking task, error code E_OBJ is returned.

Comments