pipx40_setChannelState
|
Function |
pipx40_setChannelState (ByVal vi As Long, ByVal subUnit As Long, ByVal channel As Long, ByVal state As Boolean) As Long | |
|
ViStatus |
pipx40_setChannelState (ViSession vi, ViUInt32 subUnit, ViUInt32 channel, ViBoolean state); |
|
Parameter |
I/O |
Description |
|
vi |
in |
Instrument handle |
|
subUnit |
in |
Numeric variable indicating in which sub-unit actions will take place |
|
channel |
in |
Numeric variable indicating which channel will be affected |
|
state |
in |
A Boolean indicating type of action, VI_ON to energise, VI_OFF to de-energise |
Return Value
0 = Successful operation. Negative values are error codes and positive values are warnings. To get a description of the error, pass the error code to pipx40_error_message.
Description
Energises or de-energises a single output channel. For a digital output, state = VI_ON sets logic '1'.
Remarks
For a single-channel multiplexer (MUX type), closing a channel results in automatic disconnection of the previously closed channel, if any.
In some high-density matrix cards the number of simultaneous crosspoint closures that can be made is restricted in order to prevent overheating. If this limit is exceeded no further crosspoints can be set and an error is reported. The maximum number of channel closures permitted can be obtained using pipx40_getClosureLimit. Limit values are such that they should not impact on normal matrix operations. Although it is possible to override the closure limit using pipx40_setDriverMode this is not recommended as overheating could endanger both the card itself and the system in which it is installed.