<< Previous | Next >>

OSMboxPost

INT8U OSMboxPost( OS_EVENT * pevent, void * msg );

Description

Sends a message to the specified mailbox.

Parameters

pevent

Pointer to mailbox's event control block.

msg

Pointer to message to be posted. A null pointer must not be sent.

Return value

OS_NO_ERR

The call was successful and the message was sent.

OS_MBOX_FULL

The mailbox already contains a message. Only one message at a time can be sent and thus, the message MUST be consumed before another can be sent.

OS_ERR_EVENT_TYPE

Attempting to post to a non-mailbox.

OS_ERR_PEVENT_NULL

If pevent is a null pointer

OS_ERR_POST_NULL_PTR

If you are attempting to post a null pointer

Library

OS_MBOX.C (Prior to DC 8:UCOS2.LIB)

See also

OSMboxAccept, OSMboxCreate, OSMboxPend, OSMboxQuery