IP_ReceiveNonblock

IP_ReceiveNonblock — receives any message, without blocking.

Syntax

#include <cogent.h>
int IP_ReceiveNonblock(IP_Task*  myself,
 IP_Msg*  rmsg,
 IP_MsgInfo*  msginfo);

Arguments

myself

A task structure referring to the current process.

rmsg

A message structure to hold the received message.

msginfo

A structure to be filled with extra information.

Returns

The type of the received message. If no message was available then -1 is returned and msginfo->rcvid is set to EAGAIN.

Description

This function receives a message of any type, but will not block if no message is available. See IP_Receive for details.

See Also

Receiving Messages and Events, IP_Receive