www.beck-ipc.com

@CHIP-RTOS C Library - RTOS API


RTX_Find_Msg

Find a message exchange, specified by 4 character name tag.

int RTX_Find_Msg ( unsigned int far *id_ptr,
                   const char far *name);

Parameters

id_ptr

Output parameter, pointer to location in callers memory which will receive the Message exchange ID if a message exchange with specified name is found.

name

Input parameter, pointer to 4 character name of message exchange to look for.   (This string need not be zero terminated, but must be four bytes.)

Return Value

0 on success else error code.

Comments

If more than one message exchange was created with the same tag, you will get back the message exchange ID of one with this tag, but which one is not certain.

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