Echelon OpenLDV - Manual (Page 47)

OpenLDV Programmer’s Guide 39
typedef struct LDVDevices
{
DWORD nInfos;
LDVDeviceInfoPtr* pInfos;
} LDVDevices;
The LDVDevices structure contains information that describes a set of
L ON W ORKS interface devices. Table 23 describes the LDVDevices structure’s
fields.
Table 23. LDVDevices Structure
Field Description
nInfos The number of Device Info pointers in the array.
pInfos An array of Device Info pointers. See LDVDeviceInfo Structure
on page 37 for information about the LDVDeviceInfo structure.
See the following functions for their use of this structure:
ldv_get_matching_devices() on page 22 and ldv_free_matching_devices() on page
20.
LdvCombineFlags Enumeration
Table 24 describes the enumerated values for the LdvCombineFlags device
capability combination flags. The device capability combination flags specify how
multiple bits are combined when determining device capability support.
Table 24. OpenLDV Device Capability Combination Flags (LdvCombineFlags)
Driver Type
Numeric
Value Description
LDV_COMBINE_DEFINITELY_ALL 0 All of the specified capabilities must
definitely exist
LDV_COMBINE_POSSIBLY_ALL 1 All of the specified capabilities must
possibly exist
LDV_COMBINE_DEFINITELY_ANY 2 Any of the specified capabilities must
definitely exist
LDV_COMBINE_POSSIBLY_ANY 3 Any of the specified capabilities must
possibly exist
The two enumeration values *_ALL specify an AND of the device capabilities,
whereas the two *_ANY values specify an OR of the device capabilities.
See the ldv_free_matching_devices() function on page 20 for its use of this
enumeration.
Example: To return all devices that are currently defined as protocol analyzers,
use the ldv_get_matching_devices() function: