====== OSA : OS_Flag_Wait_On_TO ======
<color blue>**OS_Flag_Wait_On_TO (flags, mask, timeout)**</color>\\ 
=== ===

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

Ожидаем установки хотя бы одного флага из маски в течение заданного времени. Если так и не дождались, то выходим из ожидания по таймауту.

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


=== Параметры функции: ===
{| class = "fpl"
|-
|//''flags''//
|Переменная типа ##[[osa:ref:description:data_types|OST_FLAGx]]## (x = 8, 16, 32)
|-
|//''mask''//
|Битовая маска, по которой произваодится операция над флагами
|-
|//''timeout''//
|Время ожидания. Задается в системных тиках - периодах вызова сервиса ##[[osa:ref:allservices:OS_Timer|OS_Timer]]##
|}


=== Возвращаемое значение: ===
{| class = "fpl"
|-
|//''таймаут''//
|Если вышли из ожидания по таймауту, то сервис ##[[osa:ref:allservices:OS_IsTimeout|OS_IsTimeout]]## возвратит **true**
|}


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

void Task (void)
{
    for (;;) {
        /*...*/
        OS_Flag_Wait_On_TO (flags, 0x51, 10);
        if (!OS_IsTimeout()) {
            //
            /*...*/
        }
        /*...*/
    }
}
</code>


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


<color gray>**OS_Flag_Wait_On**</color>\\ 





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

  * [[osa:ref:allservices:OS_Flag_Set|OS_Flag_Set]]
  * [[osa:ref:allservices:OS_Flag_Clear|OS_Flag_Clear]]

  * [[osa:ref:allservices:OS_Flag_Check_AllOn|OS_Flag_Check_AllOn]]
  * [[osa:ref:allservices:OS_Flag_Check_On|OS_Flag_Check_On]]
  * [[osa:ref:allservices:OS_Flag_Check_AllOff|OS_Flag_Check_AllOff]]
  * [[osa:ref:allservices:OS_Flag_Check_Off|OS_Flag_Check_Off]]

  * [[osa:ref:allservices:OS_Flag_Wait_AllOn|OS_Flag_Wait_AllOn]]
  * [[osa:ref:allservices:OS_Flag_Wait_On|OS_Flag_Wait_On]]
  * [[osa:ref:allservices:OS_Flag_Wait_AllOff|OS_Flag_Wait_AllOff]]
  * [[osa:ref:allservices:OS_Flag_Wait_Off|OS_Flag_Wait_Off]]

  * [[osa:ref:allservices:OS_Flag_Wait_AllOn_TO|OS_Flag_Wait_AllOn_TO]]
  * [[osa:ref:allservices:OS_Flag_Wait_AllOff_TO|OS_Flag_Wait_AllOff_TO]]
  * [[osa:ref:allservices:OS_Flag_Wait_Off_TO|OS_Flag_Wait_Off_TO]]

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