OSA : OS_Queue_IsFull

bool OS_Queue_IsFull (queue)
bool OS_Queue_IsFull_I (queue)

Check if queue of messages is full.

OS_ENABLE_QUEUE constant must be defined in OSAcfg.h.

For PIC16, message queues can be allocated only in bank0 or bank1

Call allowed:

Everywhere

Parameters:

queue Queue of messages descriptor. Variable of OST_QUEUE type.

Returns:

false there is room to add a new message
true queue is full

Example:

OST_QUEUE queue;
 
void Task (void)
{
    char buf[10];
    for (;;) {
        /*...*/
        if (!OS_Queue_IsFull (queue)) {                 // If there is room
            OS_Queue_Send_Now(queue, (OST_MSG)&buf);    // then send message
        };
        /*...*/
    }
}

Old style name

OS_IsQMsgFull

See also