Chapter 6
NI-FBUS Function Reference
NI-FBUS Hardware and Software User Manual
6-4
ni.com
nifDownloadDomain
Purpose
Downloads data to the virtual field device (VFD) domain.
Format
nifError_t
nifDownloadDomain(
nifDesc_t ud,
uint32 index,
char *fileName);
Input
ud
The descriptor of the VFD you are accessing with
index
.
index
The absolute VFD index value of the domain you specified to
download the data.
fileName
The name of the file where the download data is stored.
Context
VFD, physical device, link, session.
Description
nifDownloadDomain
is used to download the data or parameter values to the specified
VFD domain. The domain is specified by
index
.
To determine the appropriate
index
value, consult the documentation of the device to which
you are trying to download the domain. If the device supports the Domain Download feature,
the
index
for download should be specified in the documentation.
Return Values
E_OK
The call was successful.
E_INVALID_DESCRIPTOR
The descriptor specified is not valid.
E_SERVER_CONNECTION_LOST
The session established with the NI-FBUS Communication
Manager, under which the descriptor was opened, has been lost or
closed.
E_RESOURCE
The NI-FBUS Communications Manager is unable to allocate a
system resource. This is usually a memory problem.
E_DEVICE_CHANGED
The device you specified has changed.
E_VFD_CHANGED
The VFD you specified has changed.