www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Send_Msg

Send provided message to a specified message exchange.

int RTX_Send_Msg ( unsigned int id, int prio,
                   const void 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.

Related Topics

RTX API   Overview

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.00V1.00V1.00V0.90V1.00

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


End of document