IP_QueueWait

IP_QueueWait -- requests notification of an event.

Syntax

int IP_QueueWait(int qid, int pulse, int eventmask);

Arguments

qid

The queue ID.

pulse

A pulse ID.

eventmask

The event on which to wait.

Returns

0 on success, or -1 on failure and errno is set.

Description

This function causes qserve to trigger the pulse when a particular event occurs. The calling process does not block waiting for the next event, but will return immediately. In order to implement a blocking wait, the programmer should use IP_QueueWait followed by IP_Receive.

The possible values for eventmask are:

If the condition for an event is already true at the time of the call to IP_QueueWait, then the pulse is triggered immediately.

See Also

Cascade QueueServer Functions, Pulses and Timers

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