IP_TaskWaitAsync

IP_TaskWaitAsync -- registers the task for events in qserve.

Syntax

int IP_TaskWaitAsync(IP_Task* task, int flags);

Arguments

task

A pointer to a task structure.

flags

The event on which to wait.

Returns

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

Description

This function causes the current task to be notified whenever the events in flags occur within qserve. This function will create a pulse, stored in task->qpulse, if necessary. When the event occurs, task->qpulse will be triggered, and will subsequently be received through IP_Receive as an IP_PULSE event type.

The possible values for flags are:

The programmer should not make this call with a task structure referring to the current process, as it is done automatically by the API.

See Also

Task Structures, IP_TaskInitAsync, IP_TaskSendAsync, IP_TaskCloseAsync

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