tk_ref_tex

Reference Task Exception Status

[C Language Interface]

ER ercd = tk_ref_tex ( ID tskid, T_RTEX *pk_rtex ) ;

[Parameters]

ID tskid Task ID

T_RTEX* pk rtex Address of packet for returning task exception status

[Return Parameters]

ER ercd Error code

pk rtex detail:

UINT pendtex Pending task exceptions

UINT texmask Allowed task exceptions

(Other implementation-dependent parameters may be added beyond this point.)

[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_PAR Parameter error (the return parameter packet address cannot be used)

[Description]

Gets the status of task exceptions for the task specified in tskid.

pendtex indicates the currently pending task exceptions. A raised task exception is indicated in pendtex from the time the task exception is raised until its task exception handler is called.

texmask indicates allowed task exceptions.

Both pendtex and texmask are bit arrays of the form 1 << task exception code.

The invoking task can be specified by setting tskid = TSK_SELF = 0. Note, however, that when a

system call is issued from a task-independent portion and tskid = TSK_SELF = 0 is specified, error code E_ID is returned.

Comments