prcv_mbx

iprcv_mbx

Outline

Receive from mailbox (polling).

C format

 ER      prcv_mbx (ID mbxid, T_MSG **ppk_msg);
 ER      iprcv_mbx (ID mbxid, T_MSG **ppk_msg);
Parameter(s)

I/O

Parameter

Description

I

 ID      mbxid;
ID number of the mailbox.

O

 T_MSG   **ppk_msg;
Start address of the message packet received from the mailbox.



[M[Message packet T_MSG for TA_MFIFO attribute ]

 typedef struct {
     VP      msghead;       /*RI600V4 management area*/
 } T_MSG;


[Message packet T_MSG_PRI for TA_MPRI attribute]

 typedef struct {
     T_MSG   msgque;        /*Message header*/
     PRI     msgpri;        /*Message priority*/
 } T_MSG_PRI;


Explanation

This service call receives a message from the mailbox specified by parameter mbxid, and stores its start address in the area specified by parameter ppk_msg.

If the message could not be received from the target mailbox (no messages were queued in the wait queue) when this service call is issued, message reception processing is not executed but "E_TMOUT" is returned.

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 in the CPU locked state.

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

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

E_TMOUT

-50

Polling failure.