DESIGN (xvwidgets) functions
LIBRARY ROUTINE
xvw_add_detectfid - add (fid) input handler to an object
LIBRARY CALL
void xvw_add_detectfid(
xvobject object,
int fid,
void (*routine)(xvobject, int, kaddr),
kaddr client_data)
INPUT
- object - object on which to place the input handler.
Pass NULL if the input handler is to be invoked
in general, and not associated with any
particular object.
- fid - the file descriptor which will be monitored
for input (or output)
- routine - the input handler routine to be called when
change on the fid is detected
- client_data - pointer to client data that
will be passed to input handler
OUTPUT
none
RETURN VALUE
none
DESCRIPTION
Causes a detection mechanism to be installed on the
specified file descriptor; the file descriptor will be
polled intermittently for change (input or output).
If a change in the file descriptor is detected, then the
specified input handler is called.
The input handler can be associated with an object, so that
fid detection is automatically discontinued when the object is
destroyed. If NULL is passed for the object, then the input
handler is added to the global file detection list.
The detect file callback must be declared in the following
form:
int input_handler(
xvobject object,
int fid,
kaddr client_data)
object -
If xvw_add_detectfid() is called with a particular
xvobject, that object will be passed into the input handle
r.
fid -
This is the file descriptor being monitored for change.
client_data -
The pointer to the client data, used to pass parameters
from the application to the input handler.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvwidgets/src/fid.c
SEE ALSO
xvwidgets(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.