Mask Crosspoint

Description

Mask or unmask a single matrix crosspoint.

Masking disables the corresponding switch for the PIPLX_OpBit, PIPLX_OpCrosspoint and PIPLX_WriteSub functions.

This facility can be used to guard against programming errors that could otherwise result in damage to matrix switches or external circuits.

Prototype

DWORD PIPLX_MaskCrosspoint(SESSION session, DWORD CardNum, DWORD OutSub, DWORD Row, DWORD Column, BOOL Action);

Parameters:

Session - The session variable obtained from the PICMLX_Connect call

CardNum - card number

OutSub - output sub-unit number

Row - crosspoint row (Y) location

Column - crosspoint column (X) location

Action - 1 to mask, 0 to unmask

Returns:

Zero for success, or non-zero error code.

Note

This function supports matrix operation using row/column co-ordinates in place of the linearized bit-number method employed by PIPLX_MaskBit. It offers more straightforward matrix operation, and avoids the need for re-coding if a matrix card is replaced by one having different dimensions.