www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Get_Msg

Get message without waiting (polling) from a specified message exchange.

int RTX_Get_Msg ( unsigned int id, void far *msg );

Parameters

id

The message exchange ID output on call to RTX_Create_Msg.

msg

Output parameter:   Pointer to a 12 byte user buffer for storing the message (if any).

Return Value

0 on success else error code.

Comments

This function returns immediately with return value -28 if no message is available.

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

When more than one message is available at the message exchange, the oldest (FIFO order) message from the highest priority message queue will be reported.

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