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

{{osa:ref:attr_call_task.png|Allowed only in task}}{{osa:ref:attr_call_ct_sw.png|Switches context}}{{osa:ref:attr_call_to.png|Uses timer}}

Same as ##[[en:osa:ref:allservices:OS_Msg_Send|OS_Msg_Send]]## with exit if timeout expires. If timeout expires before //msg_cb// is free then new message will not be sent.


=== Call allowed: ===
Only in task


=== Parameters: ===
{| class = "fpl"
|-
|//''msg_cb''//
|Pointer to message descriptor. Variable of ##[[en:osa:ref:description:data_types#OST_MSG_CB|OST_MSG_CB]]## type
|-
|//''message''//
|pointer to message body (##[[en:osa:ref:description:data_types#OST_MSG|OST_MSG]]##)
|-
|//''timeout''//
|Time of waiting in system ticks - calling ##[[en:osa:ref:allservices:OS_Timer|OS_Timer]]## periods
|}


=== Returns: ===
{| class = "fpl"
|-
|//''timeout''//
|If timeout expired then system service ##[[en:osa:ref:allservices:OS_IsTimeout|OS_IsTimeout]]## will return **true**
|}


=== Example: ===
<code cpp>
OST_MSG_CB msg_cb;

void Task (void)
{
    OST_MSG msg;
    static char buf[10];
    for (;;) {
        /*...*/
        OS_Msg_Send_TO (msg_cb, buf, 100);
        if (OS_IsTimeout()) {
            // Message is not sent!
            /*...*/
        }
        /*...*/
    }
}
</code>


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








=== See also ===
  * [[en:osa:ref:allservices:OS_Msg_Create|OS_Msg_Create]]

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


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

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

----
  * [[en:osa:ref:services:alphabetical|Alphabetical]]
  * [[en:osa:ref:services:brieflist|All services]]
~~UP~~