pipx40_getCrosspointState

ViStatus pipx40_getCrosspointState (ViSession instrumentHandle, ViUInt32 subunitNumber, ViUInt32 row, ViUInt32 column, ViPBoolean state);

Purpose

Obtains the state of an individual matrix crosspoint.

Parameters

Input
Name Type Description
instrumentHandle ViSession

Instrument handle obtained by the pipx40_init call used to open the card.

subunitNumber ViUInt32

The number of the sub-unit to access.
Valid Values:  1 thru the number of output sub-units
available on the chosen card

row ViUInt32

The row (Y) location of the crosspoint whose state is to be obtained.
Valid Values:  1 thru the number of rows available on the
chosen sub-unit

column ViUInt32

The column (X) location of the crosspoint whose state is to be obtained.
Valid Values:  1 thru the number of columns available on the
chosen sub-unit

Output
Name Type Description
state ViBoolean (passed by reference)

Variable to receive the chosen crosspoint's state.
Values:        VI_OFF = crosspoint inactive
VI_ON  = crosspoint active

Return Value

Name Type Description
status ViStatus

A numeric code indicating the success or failure of the operation.
VI_SUCCESS = Successful operation.
Negative values are error codes and positive values are warnings.
To get a description of an error, pass the error code to pipx40_error_message.

References

Specialised Switching
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index