pipx40_setCrosspointMask

ViStatus pipx40_setCrosspointMask (ViSession instrumentHandle, ViUInt32 subunitNumber, ViUInt32 row, ViUInt32 column, ViBoolean action);

Purpose

Allows an individual matrix crosspoint to be masked or unmasked. When masked, a channel cannot be activated by the functions pipx40_setChannelState, pipx40_setCrosspointState and pipx40_setChannelPattern.

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 to be masked/unmasked. Valid Values: 1 thru the number of rows available on the chosen sub-unit
column	ViUInt32	The column (X) location of the crosspoint to be masked/unmasked. Valid Values: 1 thru the number of columns available on the chosen sub-unit
action	ViBoolean	Determines if the chosen crosspoint is to be masked or unmasked. Valid Values: 0 or 1 0 = Unmask the crosspoint 1 = Mask the crosspoint

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