get_tim/iget_tim | CS+ V8.02.00

get_tim

iget_tim

Outline

Reference system time.

C format
 ER      get_tim (SYSTIM *p_systim);
 ER      iget_tim (SYSTIM *p_systim);
Parameter(s)
I/O

Parameter

Description
O
 SYSTIM  *p_systim;
Current system time.
[System time packet: SYSTIM]
 typedef struct  systim {
     UH      utime;          /*System time (higher 16 bits)*/
     UW      ltime;          /*System time (lower 32 bits)*/
 } SYSTIM;
Explanation

These service calls store the RI600PX system time (unit: msec) into the area specified by parameter p_systim.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_PAR

-17

Parameter error.

- p_systim == NULL

E_CTX

-25

Context error.

- This service call was issued in the CPU locked state.

- This service call was issued in the status PSW.IPL > kernel interrupt mask level.

Note When the iget_tim is issued from task or the get_tim is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.

E_MACV

-26

Memory access violation. (only for get_tim)

- The operand-write access to the area indicated by p_systim has not been permitted to the invoking task.

Macro	Value	Description
E_OK	0	Normal completion.
E_PAR	-17	Parameter error. - p_systim == NULL
E_CTX	-25	Context error. - This service call was issued in the CPU locked state. - This service call was issued in the status PSW.IPL > kernel interrupt mask level. Note When the iget_tim is issued from task or the get_tim is issued from non-task, the context error is not detected and normal operation of the system is not guaranteed.
E_MACV	-26	Memory access violation. (only for get_tim) - The operand-write access to the area indicated by p_systim has not been permitted to the invoking task.