niFgen Import Attribute Configuration (poly) VI

Installed With: NI-FGEN

Imports a configuration to the session from either a file or a buffer.

You can export and import supported configurations only between NI‑FGEN devices with identical bus types, model numbers, and channel counts, as well as the same number of initialized channels.

Note  You cannot call this VI while the session is in the Running/Generating state.

Supported Configurations

You can export and import the following between NI‑FGEN sessions:

• Attribute configurations
• Arbitrary waveforms

Related topics:

Programming State Model

Setting Attributes Before Reading Attributes

Output Modes

Details

niFgen Import Attribute Configuration File

Imports a configuration to the session from the specified file.

	Instrument Handle identifies your instrument session. Instrument Handle is obtained from the niFgen Initialize VI, niFgen Initialize With Options VI, or the niFgen Initialize With Channels VI.
	file path is the absolute path to the file that contains the configuration to import. If you specify an empty or relative path, this VI returns an error. Default file extension: .nifgenconfig
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality. Default value: no error
	Instrument Handle Out passes a reference to your instrument session to the next VI.
	error out contains error information. This output provides standard error out functionality.

niFgen Import Attribute Configuration Buffer

Imports a configuration to the session from the specified buffer.

	Instrument Handle identifies your instrument session. Instrument Handle is obtained from the niFgen Initialize VI, niFgen Initialize With Options VI, or the niFgen Initialize With Channels VI.
	buffer is a byte array that contains the configuration to import.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality. Default value: no error
	Instrument Handle Out passes a reference to your instrument session to the next VI.
	error out contains error information. This output provides standard error out functionality.

Details

Requirements for Exporting and Importing Arbitrary Waveforms

Arbitrary waveforms you export and import between sessions using this VI must meet the following criteria:

• All waveforms in the exporting session are created from files, other than HWS files, using the niFgen Create Waveform (poly) VI
• The full file path of the file containing the arbitrary waveform still exists upon import
• All waveforms are defined using handles rather than names
• All waveforms are complete—none are streamed or incrementally written

You can set the device mode with the niFgen Configure Output Mode VI. For more information on arbitrary waveform mode, refer to Arbitrary Waveform Output Mode and Configure Arbitrary Waveform Mode.

Channel Mapping Behavior

When exporting and importing configurations between NI‑FGEN sessions that were initialized with different channels using the channel name input to the niFgen Initialize With Channels VI, the configuration of the exporting channel is mapped to the importing channel.

For example, if your entry for channel name is 0 for the exporting session and 1 for the importing session, the configuration exported from channel 0 is imported into channel 1.

Note  This VI will return an error if the total number of channels initialized for the exporting session is not equal to the total number of channels initialized for the importing session.