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.
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)
resource name
Resource name of the switch module to initialize.
IVI logical names are also valid resource names.
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
|
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
|
error in
Error conditions that occur before this node runs.
The node responds to this input according to 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
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.
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:
TRUE (1)
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.
error out
Error information.
The node produces this output according to 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
Web Server: Not supported in VIs that run in a web application