![background image](http://html1.mh-extra.com/html/national-instruments/foundation-ni-fbus/foundation-ni-fbus_hardware-and-software-user-manual_709117110.webp)
Chapter 6
NI-FBUS Function Reference
NI-FBUS Hardware and Software User Manual
6-48
ni.com
nifReadObjectList
Purpose
Reads the values of several objects from a device or several devices.
Format
nifError_t
nifReadObjectList (
nifDesc_t ud,
char **blkParamList,
uint16 numObjects,
void *buffer,
uint16 *length,
nifError_t *errArray)
Input
ud
The descriptor of the session, link, physical device, VFD,
or block.
blkParamList
The list of parameter names your application reads in the form
of
BLOCKTAG.PARAM
. To specify any parameter by index use
the
NIFB_INDEX
macro. To specify any parameter that is an
array or structure element by index and subindex, use the
NIFB_INDEX_SUBINDEX
macro. To specify a named structure
element, supply the parameter name in the form of
BLOCKTAG.STRUCT.ELEMENT
.
numObjects
The number of parameter names specified in
blkParamList
.
(The maximum number of objects that can be specified in
blkParamList
is given by the constant
MAX_LIST_ELEMS
.)
length
The size of the buffer to hold the result of all the parameter reads,
in bytes.
Output
buffer
The values of all the parameters read, stored as a continuous string
of bytes.
length
The cumulative size of the actual resulting data in bytes.
errArray
The error codes resulting from each parameter read. The error
codes have a one-to-one correspondence with the order in which
the parameters are specified in
blkParamList
.
Context
Session, link, device, VFD, block.