====== OSA : OS_Squeue_Wait ======
<color blue>**OS_Squeue_Wait (squeue, os_smsg_type_var)**</color>\\ 
=== ===

{{osa:ref:attr_call_task.png|Allowed only in task}}{{osa:ref:attr_call_ct_sw.png|Switches context}}

Wait for simple message from queue.

##[[en:osa:ref:appendix:configuration#System constants|OS_ENABLE_SQUEUE]]## constant must be defined in ##[[en:osa:ref:appendix:configuration|OSAcfg.h]]##.
<note>
For PIC16, message queues can be allocated only in **bank0** or **bank1**
</note>


=== Call allowed: ===
Only in task


=== Parameters: ===
{| class = "fpl"
|-
|//''squeue''//
|Queue of simple messages descriptor. Variable of ##[[en:osa:ref:description:data_types#OST_SQUEUE|OST_SQUEUE]]## type.
|-
|//''os_smsg_type_var''//
|Variable of ##[[en:osa:ref:description:data_types#OST_SMSG|OST_SMSG]]## type, where simple message will be placed
|}


=== Returns: ===
nothing

=== Example: ===
<code cpp>
OST_SQUEUE squeue;

void Task (void)
{
    OST_SMSG smsg;
    for (;;) {
        /*...*/
        OS_Squeue_Wait(squeue, smsg);  // Wait for simple message and store
                                       // it into smsg
        /*...*/
    }
}
</code>


=== Old style name ===
<color gray>**OS_WaitQSMsg**</color>\\ 








=== See also ===
  * [[en:osa:ref:allservices:OS_Squeue_Create|OS_Squeue_Create]]

  * [[en:osa:ref:allservices:OS_Squeue_Send|OS_Squeue_Send]]
  * [[en:osa:ref:allservices:OS_Squeue_Send_TO|OS_Squeue_Send_TO]]
  * [[en:osa:ref:allservices:OS_Squeue_Send_Now|OS_Squeue_Send_Now]]


  * [[en:osa:ref:allservices:OS_Squeue_Check|OS_Squeue_Check]]
  * [[en:osa:ref:allservices:OS_Squeue_IsFull|OS_Squeue_IsFull]]

  * [[en:osa:ref:allservices:OS_Squeue_Wait_TO|OS_Squeue_Wait_TO]]

----
  * [[en:osa:ref:services:alphabetical|Alphabetical]]
  * [[en:osa:ref:services:brieflist|All services]]
~~UP~~