www.beck-ipc.com

@CHIP-RTOS C Library V2.00 - RTOS API


RTX_Send_Msg

Send provided message to a specified message exchange.

int RTX_Send_Msg ( unsigned int id, int prio,
                   const char far *msg );

Parameters

id

The message exchange ID output on call to RTX_Create_Msg.

prio

Message priority (mailbox) 0 - 3 where 0 is highest priority

msg

Pointer to a 12 byte message to be sent

Return Value

0 on success else error code.

Comments

If one or more tasks are waiting at the exchange for a message, the message will be immediately given to the task waiting at the head of the exchange's wait queue.   A task switch occurs immediately if called for based on task priorities.

The format of the 12 byte message being sent is defined by the application program.

Messages will be reported in message priority order, and from each priority queue in FIFO order.

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.


This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document