National Instruments FOUNDATION NI-FBUS Hardware And Software User Manual page 69

nifGetDeviceList
Purpose
Returns the list of information for all active devices on the network.
Format
nifError_t
Input
link
numDevices
revision
Output
devInfo
numDevices
revision
Context
Link.
Description
nifGetDeviceList
is a group of Fieldbus devices connected across a single wire pair with no intervening bridges.
Before
nifGetDeviceList
argument passed in differs from the live list revision number the Fieldbus interface keeps for
the specified link. The revision numbers the Fieldbus interface keeps start at one, so if you
pass in a zero for
current device list. To use
parameter output from the previous call to
revision
calls to it. Using the revision parameter output from the previous call forces
nifGetDeviceList
list of information.
© National Instruments Corporation
nifGetDeviceList(nifDesc_t link,
nifDeviceInfo_t *devInfo,
uint16 *numDevices,
uint16 *revision)
The link descriptor for which to return information.
The number of allocated list entries.
The revision number from the last
or zero (refer to the Description section for usage).
The list of device information.
The number of devices present in the link.
Current revision number of the live list that the NI-FBUS
Communications Manager reads from the Fieldbus interface to
the specified link.
returns a list of information describing each device on the link. A link
returns the list of information, it waits until the revision
, you can force
revision
nifGetDeviceList
to wait until the device list has actually changed before returning the
Chapter 6
nifGetDeviceList
nifGetDeviceList
most effectively, you should pass in the
nifGetDeviceList
6-7 NI-FBUS Hardware and Software User Manual
NI-FBUS Function Reference
call,
to immediately return the
in subsequent