vrst_mbx

Outline

Reset mailbox.

C format

 ER      vrst_mbx (ID mbxid);
Parameter(s)

I/O

Parameter

Description

I

 ID      mbxid;
ID number of the mailbox.



Explanation

This service call reset the mailbox specified by parameter mbxid.

The messages having been accumulated by the mailbox come off from the management of the RI600PX.

Note 1 In this service call, the tasks to wait to receive message do not released from the WAITING state.

Note 2 This service call is the function outside mITRON4.0 specification.

Return value

Macro

Value

Description

E_OK

0

Normal completion.

E_ID

-18

Invalid ID number.

- mbxid < 0

- mbxid > VTMAX_MBX

E_CTX

-25

Context error.

- This service call was issued from a non-task.

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

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

E_MACV

-26

Memory access violation.

- Stack pointer points out of user stack for invoking task.

E_NOEXS

-42

Non-existent object.

- The mailbox specified by mbxid does not exist.