Mask Bit

Description

Mask or unmask a single output bit.

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

This facility is particularly useful for matrix sub-units, where it can be used to guard against programming errors that could otherwise result in damage to matrix switches or external circuits. Note that PIPLX_MaskCrosspoint allows more straightforward use of row/column co-ordinates with matrices.

Prototype

DWORD PIPLX_MaskBit(SESSION session, DWORD CardNum, DWORD OutSub, DWORD BitNum, BOOL Action);

Parameters:

Session - The session variable obtained from the PICMLX_Connect call

CardNum - card number

OutSub - output sub-unit number

BitNum - output bit number

Action - 1 to mask, 0 to unmask

Returns:

Zero for success, or non-zero error code.