====== OSA : OS_Qtimer_Get ======
<color blue>**OST_TIMER OS_Qtimer_Get (qtimer)**</color>\\ 
=== ===

{{osa:ref:attr_call_to.png|Сервис использует таймаут}}

Получить оставшееся время счета. Перед вызовом этого сервиса нужно:
  * либо запретить прерывания (##[[osa:ref:allservices:OS_DI|OS_DI]]##());
  * либо войти в критическую секцию;

В противном случае в момент чтения таймера может произойти прерывание, которое может изменить его значение.

Для использования очереди таймеров в файле ##[[osa:ref:appendix:configuration|OSAcfg.h]]## нужно определить константу ##[[osa:ref:appendix:configuration#Системные константы|OS_ENABLE_QTIMERS]]##. Разрядность таймеров в очереди задается константой ##[[osa:ref:appendix:configuration#Типы данных|OS_QTIMER_SIZE]]##.

=== Разрешен вызов: ===
Везде


=== Параметры функции: ===
{| class = "fpl"
|-
|//''qtimer''//
|Дескриптор таймера типа ##[[osa:ref:description:data_types#OST_QTIMER|OST_QTIMER]]##. Содержит счетчик таймера, а также информацию о состоянии (считает,активен, переполнение). Для PIC16 может размещаться в памяти только в **bank0** или **bank1**
|}


=== Возвращаемое значение: ===
{| class = "fpl"
|-
|//''[[osa:ref:description:data_types#OST_TIMER|OST_TIMER]]''//
| Время, оставшееся до переполнения (в системных тиках)
|}


=== Пример вызова: ===

<code cpp>
OST_QTIMER qtimer;

void Task (void)
{
    char itemp;
    for (;;) {
        /*...*/
        itemp = OS_DI();
        if (OS_Qtimer_Get(qtimer) < 10)   // Зажечь зеленый светодиод, если
            GREEN_LED = 1;                // осталось менее 10 тиков счета
        OS_RI(itemp);
        /*...*/
    }
}
</code>



=== См. также ===

  * [[osa:ref:allservices:OS_Qtimer_Create|OS_Qtimer_Create]]
  * [[osa:ref:allservices:OS_Qtimer_Delete|OS_Qtimer_Delete]]

  * [[osa:ref:allservices:OS_Qtimer_Run|OS_Qtimer_Run]]
  * [[osa:ref:allservices:OS_Qtimer_Break|OS_Qtimer_Break]]
  * [[osa:ref:allservices:OS_Qtimer_Delay|OS_Qtimer_Delay]]
  * [[osa:ref:allservices:OS_Qtimer_Wait|OS_Qtimer_Wait]]

  * [[osa:ref:allservices:OS_Qtimer_Get|OS_Qtimer_Get]]
  * [[osa:ref:allservices:OS_Qtimer_Check|OS_Qtimer_Check]]
  * [[osa:ref:allservices:OS_Qtimer_IsRun|OS_Qtimer_IsRun]]


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