<< Previous | Next >>

OSMboxAccept

void * OSMboxAccept( OS_EVENT * pevent );

Description

Checks the mailbox to see if a message is available. Unlike OSMboxPend(), OSMboxAccept() does not suspend the calling task if a message is not available.

Parameters

pevent

Pointer to the mailbox's event control block.

Return value

!= (void *)0

This is the message in the mailbox if one is available. The mailbox is cleared so the next time OSMboxAccept() is called, the mailbox will be empty.

== (void *)0

The mailbox is empty, or pevent is a null pointer, or you didn't pass the proper event pointer.

Library

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

See also

OSMboxCreate, OSMboxPend, OSMboxPost, OSMboxQuery