====== OSA : OS_Msg_Send_TO ======
<color blue>**OS_Msg_Send_TO (msg_cb, message, timeout)**</color>\\ 
<color blue>**OS_Msg_Send_I (msg_cb, message, timeout)**</color>\\ 
=== ===

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

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

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


=== Параметры функции: ===
{| class = "fpl"
|-
|//''msg_cb''//
|Дескриптор указателя на сообщение. Переменная типа ##[[osa:ref:description:data_types#OST_MSG_CB|OST_MSG_CB]]##
|-
|//''message''//
|указатель на тело сообщения (тип ##[[osa:ref:description:data_types#OST_MSG|OST_MSG]]##
|-
|//''timeout''//
|Время ожидания. Задается в системных тиках - периодах вызова сервиса ##[[osa:ref:allservices:OS_Timer|OS_Timer]]##
|}


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


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

void Task (void)
{
    OST_MSG msg;
    static char Buffer[10];
    for (;;) {
        /*...*/
        OS_Msg_Send_TO (msg_cb, Buffer, 100);  // Пытаемся отправить сообщение. Если
                                               // дескриптор занят, то в течение 100
                                               // тиков ждем его освобождения.
        if (OS_IsTimeout()) {                  // Если дескриптор так и не освободился, 
                                               // то обрабатываем эту ошибку
            /*...*/
        }
        /*...*/
    }
}
</code>


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










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

  * [[osa:ref:allservices:OS_Msg_Send|OS_Msg_Send]]
  * [[osa:ref:allservices:OS_Msg_Send_Now|OS_Msg_Send_Now]]


  * [[osa:ref:allservices:OS_Msg_Check|OS_Msg_Check]]
  * [[osa:ref:allservices:OS_Msg_Accept|OS_Msg_Accept]]

  * [[osa:ref:allservices:OS_Msg_Wait|OS_Msg_Wait]]
  * [[osa:ref:allservices:OS_Msg_Wait_TO|OS_Msg_Wait_TO]]

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