IOtech Personal488, User Manual

Page: 91 / 150

Personal488 for Windows 95/98/Me/NT/2000
04-10-01
API Reference 6-23
KeepDevice
Syntax
INT WINAPI KeepDevice(DevHandleT devHandle);
devHandle refers to an external device.
Returns
-1 if error
Bus States None
Example errorcode = KeepDevice(scope);
See Also
MakeDevice, MakeNewDevice, RemoveDevice, OpenName
Note:
KeepDevice
will update an existing device or will create a new device in the Registry. This
update feature is new and useful. For example, if you wish to change the bus address of the
device and make it a permanent change.
The
KeepDevice
command changes the indicated temporary Driver488 device to a permanent device,
visible to all applications. Permanent Driver488 devices are not removed when Driver488 is closed.
Driver488 devices are created by
MakeDevice
and are initially temporary. Unless
KeepDevice
is used,
all temporary Driver488 devices are forgotten when Driver488 is closed. The only way to remove the
permanent device once it has been made permanent by the
KeepDevice
command, is to use the
RemoveDevice
command.