Table Of Contents

Initialize With Topology (G Dataflow)

Version:
Last Modified: March 3, 2017

Returns a session handle used to identify the switch module in all subsequent instrument driver calls and sets the topology of the switch module.

By default, the switch module is reset to a known state.

connector_pane_image
datatype_icon

simulate

Boolean value that enables simulation of the switch module specified in resource name.

TRUE Enables simulation of the switch module.
FALSE (Default) Disables simulation of the switch module.

Default: False (0)

datatype_icon

resource name

Resource name of the switch module to initialize. IVI logical names are also valid resource names.

Syntax

Optional fields are shown in square brackets ([]). The default values for optional fields are as follows:

chassis ID = 1

bus number = 0

Configured in MAX Under Valid Syntax
Devices and Interfaces DeviceName
Traditional NI-DAQ (Legacy) SCXI[chassis ID]::slot number
PXI System PXI[bus number]::device number

Resource Name Examples

The following table lists example resource names.

Resource Name Description
SC1Mod3 NI-DAQmx module in chassis SC1 Slot 3
MySwitch NI-DAQmx module renamed to MySwitch
SCXI1::3 Traditional NI-DAQ (Legacy) module in chassis 1, Slot 3
SCXI::3 Traditional NI-DAQ (Legacy) module in chassis 1, Slot 3
PXI0:16 PXI bus 0, device number 16
PXI::16 PXI bus 0, device number 16
datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

topology name

Topology to use for the switch module specified in resource name. Create a control for topology name to select from a list of topologies.

This topology overrides the topology specified in MAX.

datatype_icon

reset device

Boolean value that specifies whether to reset the switch module during initialization.

TRUE (Default) Specifies to reset the switch module during initialization.
FALSE Specifies that the switch module is not reset during initialization.
spd-note-note
Note  

The first call to the niSwitch Initialize With Topology node after you reboot your computer resets the hardware. This is the only case when the Reset flag is not honored.

Default: TRUE (1)

datatype_icon

session out

Indicator that identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology node, the niSwitch Initialize With Options node, or the niSwitch Initialize node and used for all subsequent NI-SWITCH calls.

datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported


Recently Viewed Topics