lext_enable_device_monitoring (ul_lextools)
status.i4.v = lext_enable_device_monitoring(monitor_func.f.v)
This routine enables monitoring of devices in an active Lextools
image which was started by a call to lext_init_active_image.
If a device is located near the cursor when the user clicks
the mouse button, it's name will be placed in the console's paste
buffer.
monitor_func function to be called each time a new device is
found (A value of NULL can be passed for this argument.)
(called as follows:
monitor_func(object_info.s.r, event_type.i4.v)
("object_info" is a structure of type
LEXT_SELECTED_OBJECT_DATA))
This function returns ACNET status values as follows:
OK success
CBS_NOINIT no image is active
CBS_DUPREQ monitoring is already enabled
CBS_NO_SUCH no devices are present
This function requires the following include files:
cnsparam_h, ul_lextools_h:lextuti_h, acnet_errors_h
Related functions:
lext_disable_device_monitoring, lext_init_active_image,
lext_remove_active_image
C/C++ usage:
int status;
lext_monitor_function monitor_func
status = lext_enable_device_monitoring(monitor_func);