
B–61863E–1/06
2. PMC SYSTEM CALLPMC LIBRARY
167
SC/SC3/SC4 NB/NB2 16i/18i/21i 15i–A
f f f f
[Name]
os_writ_mbx
[Description]
Writes the low-order four bytes into the message entry of the mailbox.
[Format]
ret = os_writ_mbx(mailbox_id,wait_limit,write_message) ;
unsigned short ret ;
unsigned char mailbox_id ;
long timeout_value ;
unsigned long write_message ;
[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
[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.25
WRITING THE
FOUR-BYTE
MESSAGE INTO THE
MAILBOX