niSwitch Initialize With Topology VI
- Updated2025-10-06
- 3 minute(s) read
Returns a session handle used to identify the switch module in all subsequent instrument driver calls and sets the topology of the switch module.
This VI creates a new IVI instrument driver session for the switch module specified in the resource name parameter. NI-SWITCH uses the topology specified in the topology name parameter and overrides the topology specified in MAX.
By default, the switch module is reset to a known state.
Enable simulation by specifying the topology and setting the simulate parameter to True.
Related Topics
Inputs/Outputs
simulate (boolean value)
—
simulate enables simulation of the switch module specified in resource name. The default value is FALSE (0).
resource name
—
resource name specifies the instrument resource name assigned by Measurement & Automation Explorer (MAX) (for example, PXI1Slot3). IVI logical names are also valid resource names. 
topology name
—
topology name specifies the topology to use for the switch module specified in resource name. Create a control for topology name to select from a list of topologies.
reset device (boolean value)
—
reset device specifies whether to reset the switch module during initialization. The default value is TRUE (1). Note The first call to the niSwitch Initialize With Topology VI after you reboot your computer will reset the hardware. This is the only case when the Reset flag is not honored.
error in (no error)
—
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. 
instrument handle out
—
instrument handle out identifies a particular NI-SWITCH session established with the niSwitch Initialize With Topology VI, the niSwitch Initialize With Options VI, or the niSwitch Initialize VI and used for all subsequent NI-SWITCH calls. 
error out
—
error out contains error information. This output provides standard error out functionality. |