pipx40_setCrosspointState
|
Function |
pipx40_setCrosspointState (ByVal vi As Long, ByVal subUnit As Long, ByVal row As Long, ByVal column As Long, ByVal state As Boolean) As Long | |
|
ViStatus |
pipx40_setCrosspointState (ViSession vi, ViUInt32 subUnit, ViUInt32 row, ViUInt32 column, ViBoolean state); |
|
Parameter |
I/O |
Description |
|
vi |
in |
Instrument handle |
|
subUnit |
in |
Numeric variable indicating in which sub-unit actions will take place |
|
row |
in |
Numeric variable indicating the row (Y) location of the crosspoint to be affected |
|
column |
in |
Numeric variable indicating the column (X) location of the crosspoint to 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 matrix crosspoint.
Note
This function supports matrix operation using row/column co-ordinates in place of the linearized channel-number method employed by pipx40_setChannelState. It offers more straightforward matrix operation, and avoids the need for re-coding if a matrix card is replaced by one having different dimensions.
Related Matrix Functions
Remarks
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 never 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.