<< Previous | Next >>

OSQPostFront

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

Description

Sends a message to the specified queue, but unlike OSQPost(), the message is posted at the front instead of the end of the queue. Using OSQPostFront() allows 'priority' messages to be sent.

Parameters

pevent

Pointer to message queue's event control block.

msg

Pointer to the message to send. A null pointer must not be sent.

Return value

OS_NO_ERR

The call was successful and the message was sent.

OS_Q_FULL

The queue cannot accept any more messages because it is full.

OS_ERR_EVENT_TYPE

A pointer to a queue was not passed.

OS_ERR_PEVENT_NULL

If pevent is a null pointer.

OS_ERR_POST_NULL_PTR

Attempting to post to a non mailbox.

Library

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

See also

OSQAccept, OSQCreate, OSQFlush, OSQPend, OSQPost, OSQQuery