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.