Receiving Messages and Events

Cogent API and Utilities: Version 4.1
Prev | Chapter 3. Interprocess Communication | Next

# 3.8. Receiving Messages and Events

The Cogent `IP_*` functions unify the process event space by treating all forms of input and notification as events.

- `IP_SetGUIHandler` - sets callback functions for GUI events.

- `IP_Receive` - receives any message.

- `IP_ReceiveNonblock` - receives any message, without blocking.

- `IP_AddFDHandler` - tells IP_Receive to accept file input.

- `IP_RemoveFDHandler` - prevents IP_Receive from accepting file input.

- `IP_SelectFD` - is used internally only.

- `IP_UnselectFD` - is used internally only.

- `IP_ProcessMessage` - classifies messages for IP_Receive.

The `IP_Receive` function can accept input from the following sources:

1. a message from another process using the Cogent `IP_*` functions

2. a message from another process using the OS IPC primitives

3. an asynchronous message via Cascade QueueServer

4. data available on a file descriptor

5. a pulse

6. a signal

7. a Photon microGUI event

8. a task death notification for `_PPF_INFORMED` tasks (QNX 4 and Linux)

Prev | Home | Next
Cascade QueueServer Functions | Up | Replying to Messages

Copyright 1995-2002 by Cogent Real-Time Systems, Inc.