Echelon OpenLDV - Manual (Page 48)

40 Using the OpenLDV API
1. Set the nCaps to LDV_DEVCAP_PA to specify protocol analyzer
capability.
2. Set nCombine to LDV_COMBINE_DEFINITELY_ALL (or
LDV_COMBINE_DEFINITELY_ANY) to specify that the function
should return all devices that definitely are defined as protocol analyzers.
If you want the function to return all devices that are definitely protocol
analyzers along with devices that might be protocol analyzers (devices
with multiple capabilities), specify LDV_COMBINE_POSSIBLY_ALL
(or LDV_COMBINE_POSSIBLY_ANY).
3. Prepare the pDevices output buffer for the returned results.
LDVCode rc = ldv_get_matching_devices(
LDV_DEVCAP_PA,
LDV_COMBINE_DEFINITELY_ALL,
*myPA_List);
LdvDeviceCaps Enumeration
Table 25 describes the enumerated values for the LdvDeviceCaps device
capabilities, which describes the capabilities of a L
ON
W
ORKS
interface device.
These constants can be OR’ed together for L ON W ORKS interface devices that
support multiple capabilities.
See ldv_open_cap() on page 25 for information about how to specify device
capabilities.
Table 25. OpenLDV Device Capabilities (LdvDeviceCaps)
Device Capability
Numeric
Value Description
LDV_DEVCAP_UNKNOWN 0x00000000 An unknown device, or a
device whose capabilities
cannot be determined
LDV_DEVCAP_L5 0x00000001 The device can operate as a
Layer 5 network interface.
LDV_DEVCAP_L2 0x00000002 The device can operate as a
Layer 2 network interface.
LDV_DEVCAP_LWIP 0x00000010 The device can operate as an
IP-852 device or channel.
These types of devices are
implemented within the LNS
Server and cannot be opened
using the OpenLDV API.
LDV_DEVCAP_PA 0x00000020 The device can operate as a
protocol analyzer interface.