pipx40_getCrosspointState
|
Function |
pipx40_getCrosspointState (ByVal vi As Long, ByVal subUnit As Long, ByVal row As Long, ByVal column As Long, ByRef state As Integer) As Long | |
|
ViStatus |
pipx40_getCrosspointState (ViSession vi, ViUInt32 subUnit, ViUInt32 row, ViUInt32 column, ViPBoolean state); |
|
Parameter |
I/O |
Description |
|
vi |
in |
Instrument handle |
|
subUnit |
in |
Numeric variable indicating in which sub-unit actions will take place |
|
row |
in |
Row (Y) location of the crosspoint whose state is to be reported |
|
column |
in |
Column (X) location of the crosspoint whose state is to be reported |
|
state |
out |
Pointer/reference to variable to receive result |
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
Reads the current state of the specified matrix crosspoint (VI_OFF = open, VI_ON = closed).
Note
This function supports matrix operation using row/column co-ordinates in place of the linearized channel-number method employed by pipx40_getChannelState. It offers more straightforward matrix operation, and avoids the need for re-coding if a matrix card is replaced by one having different dimensions.