OSA : OS_Squeue_Check

bool OS_Squeue_Check (squeue)
bool OS_Squeue_Check_I (squeue)

Check if there is any message in queue of simple messages.

OS_ENABLE_SQUEUE constant must be defined in OSAcfg.h.

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

Call allowed:

Everywhere

Parameters:

squeue Queue of simple messages descriptor. Variable of OST_SQUEUE type.

Returns:

false queue is empty
true there is at least one simple message in queue

Example:

OST_SQUEUE squeue;
 
void Task (void)
{
    OST_SMSG smsg;
    for (;;) {
        /*...*/
        if (OS_Squeue_Check (squeue)) {         // If simple message present
            OS_AcceptSQueue(squeue, smsg);      // then accept it
            /*...*/
        }
        /*...*/
    }
}

Old style name

OS_CheckQSMsg

See also