Initialize With Topology

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.

Inputs/Outputs

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 value: 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
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
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

Default value: 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.
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 value: 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