IPC@CHIP Documentation - SC12 @CHIP-RTOS V1.10

Comments
typedef struct tag_rtx_wait_msg{
unsigned int msgID; // ID of the message exchange
unsigned int prio; // Priority for wait [0 .. 0xFFFF], 0 = highest
char far *msg; // Pointer to user buffer to store the arrived message
long timeout; // Maximum time (milliseconds) for waiting for a message
} RTX_Wait_Msg;
This structure is defined in the header file rtxapi.h.
Prior to calling the RTX_WAIT_MSG ALI, the caller must set the following members of the RTX_Wait_Msg structure.
msgID
Here you put the message exchange ID acquired by the RTX_CREATE_MSGcall.
prio
msg
Specify here the priority of the calling task's access to the messages. To wait in FIFO order, have all
RTX_WAIT_MSGAPI callers use the same value here. A task can cut in line ahead of other waiting tasks by
setting this field to a higher priority (lower number) than used by the other tasks. (Note that this priority has no
connection to either taskpriority or Message send mailboxpriority.)
Put here a far pointer to a 12 byte buffer allocated in your application program memory. The Message
Exchange Manager will copy the message to this buffer if a message is available.
timeout
Here you can specify the maximum number of milliseconds you are willing to wait for a message. A value of
zero indicates you will wait forever. Negative values are not permitted.
Related Topics
Top of list
Index page
API function RTX_WAIT_MSG - Wait for a message from a message exchange
RTOS Message Exchange Manager
TaskDefBlock
Comments
typedef struct tag_taskdefblock
{
void (far *proc)(); // Task entry vector (far)
char name[4]; // Task name, 4 characters not null terminated
unsigned int far *stackptr; // Task stack pointer (far)
unsigned int stacksize; // size of stack (bytes)
unsigned short attrib; // task attributes (not supported by the RTOS API)
short int priority; // task priority, range: 3..127 inclusive
unsigned short time_slice; // 0: none, !=0: number of milliseconds before task
// is forced to relinquish processor
short mailboxlevel1; // not used
short mailboxlevel2; // not used
short mailboxlevel3; // not used
short mailboxlevel4; // not used
} TaskDefBlock;
This structure is defined in the header file rtxapi.h.
Page 238 / 400