~~NOTOC~~
===== tn_sem_polling() =====

Сервис предназначен для захвата одного ресурса семафора без перевода задачи в состояние ожидания.

Если счетчик свободных ресурсов семафора больше нуля (семафор свободен), он уменьшается на единицу. Если счетчик свободных ресурсов семафора равен нулю (семафор захвачен), сервис возвращает код ''TERR_TIMEOUT''. Счетчик ресурсов семафора не меняется. В любом случае задача не блокируется.

**Вызов:**
<code cpp>
TN_RETVAL tn_sem_polling (TN_SEM *sem);
</code>

**Разрешен вызов:** \\ 

В контексте задачи

**Параметры функции:**

  ; ''sem'' : указатель на структуру семафора

\\ 

**Возвращаемые значения:**  

  ; ''TERR_WRONG_PARAM'' : некорректное значение параметра (__замечание:__ данный код возврата возможен только в случае использования сервисов с проверкой параметров)
  ; ''TERR_NOEXS'' : попытка захвата объекта, не являющегося семафором.
  ; ''TERR_WCONTEXT'' : попытка захвата семафора в прерывании или в пользовательской критической секции
  ; ''TERR_TIMEOUT'' : семафор уже захвачен
  ; ''TERR_NO_ERR'' : успешное выполнение


\\ 
**Пример вызова:**  
<code cpp>
TN_SEM    sem_test;

if (tn_sem_polling(&sem_test) == TERR_NO_ERR)
{
    /* ... */
}
</code>

\\ 

----
[[tnkernel:ref:sem:intro#Сервисы управления семафорами|К списку сервисов]]