Everything

get_ims

iget_ims

Outline
Reference interrupt mask.
C format
 ER      get_ims (IMASK *p_imask);
 ER      iget_ims (IMASK *p_imask);
Parameter(s)
I/O
Parameter
Description
O
 IMASK    *p_imask;
Pointer to the area returning the interrupt mask.

Explanation
These service calls store PSW.IPL into the area specified by parameter p_imask.
Note 1 These service call do not detect the context error.
Note 2 The following intrinsic functions provided by compiler are higher-speed than this service call. See "CubeSuite+ RX Coding" for details about intrinsic functions.
- get_ipl() : Refers to the interrupt priority level.
- get_psw() : Refers to PSW value.
Return value
Macro
Value
Description
E_OK
0
Normal completion.
E_PAR
-17
Parameter error.
- p_imask == NULL
E_MACV
-26
Memory access violation. (only for get_ims)
- The operand-write access to the area indicated by p_imask has not been permitted to the invoking task.