Echelon OpenLDV User Manual download pdf (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

ONWORKS 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:

1 2 ... 42 43 44 45 46 47 48 49 50 51 52 ... 193 194

No comments

Echelon OpenLDV User Manual Page 47