| N F O _ W A I T B A C K ( )
| | | | | SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English AMIGA - NFO_#?
----------------------------------------------------------------------------
NAME
nfo_waitback() - Wait/check for particular task or port.
SYNOPSIS
addr = nfo_waitback(name, flags, timeout, termsig);
ULONG nfo_waitback(UBYTE *, ULONG, LONG, ULONG);
FUNCTION
This function allows, to wait or to check for particular
task or port. Function is timeout and termination signal
assisted.
INPUTS
name - NULL terminated string containing either task
name or process name(square bracket braced),
or task address or process number(1-4096).
Notation of integers is what 'cnv_AtoULONG()'
can do. AmigaOS pattern matching works here.
flags - Where to perform the search. See header file.
All flags that dont take the argument can be
used, maybe except for QDEV_NFO_KTM_FMASS who
has no effect.
timeout - Timeout in seconds. 0 means one time check.
termsig - Additional termination signal(masked one).
RETURNS
Returns an address of first found task/port or 0 when
nothing was found.
BASES
SysBase, DOSBase
NOTES
This function allows to wait for multiple tasks or ports
at once. Specify task or port names by delimiting them
with commas(',') - Logical AND. You can also use pattern
syntax using normal brackets and delimiting names inside
with pipe('|') - Logical OR.
When waiting for a port an address of the port will be
returned and not the address of the task that did create
it!
SEE ALSO
EXAMPLE
None.
BUGS
None known.
----------------------------------------------------------------------------
| |
| |