====== OSA : OS_Queue_Wait ======
<color blue>**OS_Queue_Wait (queue, os_msg_type_var)**</color>\\ 
=== ===

{{osa:ref:attr_call_task.png|Разрешен вызов только в контексте задачи}}{{osa:ref:attr_call_ct_sw.png|Переключает контекст}}

Ожидаем сообщение из очереди //queue//.

Для использования очередей сообщений в файле ##[[osa:ref:appendix:configuration|OSAcfg.h]]## должна быть определена константа ##[[osa:ref:appendix:configuration#Системные константы|OS_ENABLE_QUEUE]]##.
<note>
Для PIC16 переменная queue может размещаться в памяти только в **bank0** или **bank1**
</note>


=== Разрешен вызов: ===
Только из задачи


=== Параметры функции: ===
{| class = "fpl"
|-
|//''queue''//
|Дескриптор очереди сообщений. Переменная типа ##[[osa:ref:description:data_types|OST_QUEUE]]##.
|-
|//''os_msg_type_var''//
|Переменная типа ##[[osa:ref:description:data_types#OST_MSG|OST_MSG]]##; в нее будет помещен указатель на сообщение
|}


=== Возвращаемое значение: ===
Нет

=== Пример вызова: ===
<code cpp>
OST_QUEUE eeprom_queue;

void Task (void)
{
    char *Data;
    for (;;) {
        /*...*/
        OS_Queue_Wait (eeprom_queue, Data);
        WriteEEPROM(Data);
        /*...*/
    }
}
</code>


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







=== См. также ===
  * [[osa:ref:allservices:OS_Queue_Create|OS_Queue_Create]]

  * [[osa:ref:allservices:OS_Queue_Send|OS_Queue_Send]]
  * [[osa:ref:allservices:OS_Queue_Send_TO|OS_Queue_Send_TO]]
  * [[osa:ref:allservices:OS_Queue_Send_Now|OS_Queue_Send_Now]]


  * [[osa:ref:allservices:OS_Queue_Check|OS_Queue_Check]]
  * [[osa:ref:allservices:OS_Queue_IsFull|OS_Queue_IsFull]]

  * [[osa:ref:allservices:OS_Queue_Wait_TO|OS_Queue_Wait_TO]]

----
  * [[osa:ref:services:alphabetical|Алфавитный указатель]]
  * [[osa:ref:services:brieflist|Все сервисы]]
~~UP~~