Echelon OpenLDV - Manual (Page 24)

16 Using the OpenLDV API
Function Description
Added in
OpenLDV
Version
ldv_read() Reads a message from an open
session.
1.0
ldv_register_event() Registers a Windows Event object to
receive notification of the
availability of new messages.
1.0
ldv_set_device_info() Creates or modifies the information
about a L
ON
W
ORKS
interface device.
2.0
ldv_set_driver_info() Creates or modifies the information
about a L ON W ORKS interface device
driver class.
2.0
ldv_write() Writes a message to an open session. 1.0
ldv_xlate_device_name() Translates a device’s logical name to
its physical name, that is, from the
device’s L ON W ORKS name (such as
“LON1”) to its Windows device name
(such as “\\.\LON1.0”).
1.0
ldvx_open() Opens a network interface device,
registers a Windows HWND object
for receiving session change
notifications.
1.0
ldvx_register_window() Registers a Windows HWND object
for receiving session change
notifications.
1.0
ldvx_shutdown() Cleanly shuts down OpenLDV and
xDriver subsystem.
1.0
Working with Devices and Drivers
The OpenLDV API includes a number of functions that assist in working with
devices and device drivers, for example:
• The ldv_get_driver_info() function allows you to identify the device
driver for a particular device. With this function, an application could
display a list of devices associated with a specific device driver.
• The ldv_get_device_info() function allows you to retrieve device
information (such as the transceiver ID of the Smart Transceiver or
Neuron Chip). For example, the transceiver ID allows an application to
determine appropriate timer and channel settings for the device based on
the available hardware.