
2. PMC SYSTEM CALL
B–61863E–1/06
PMC LIBRARY
168
SC/SC3/SC4 NB/NB2 16i/18i/21i 15i–A
f f f f
[Name]
os_wrt2_mbx
[Description]
Writes the eight bytes into the message entry of the mailbox.
[Format]
ret = os_wrt2_mbx(mailbox_id,wait_limit,
write_message_lo,write_message_hi) ;
unsigned short ret ;
unsigned char mailbox_id ;
long timeout_value ;
unsigned long write_message_lo ;
unsigned long write_message_hi ;
[Input]
mailbox_id Mailbox ID (10 to 39)
timeout_value If the mailbox is full:
S For a positive value, the limit time waiting state is
set (one count: eight milliseconds).
S For 0, there is no limit time waiting state.
S For a negative value, the permanent waiting state
is set.
write_message_lo
write_message_hi
[Output]
______
[Returns]
ret Completion code
0 ; The message has been written normally into the mailbox.
0108H ; The mailbox ID is out of range (other than 10 to 39).
0114H ; There is no specified mailbox ID.
0118H ; The specified mailbox ID was deleted.
011AH ; The specified limit time has elapsed (for timeout_value > 0).
[Remarks]
If the mailbox is full, the task enters the wait state.
2.26
WRITING THE
EIGHT-BYTE
MESSAGE INTO THE
MAILBOX