unsigned long PIPLX_WriteMask (long session, unsigned long cardNumber, unsigned long outputSubunit, unsigned long data[], unsigned long dataLength);
Sets a sub-unit's switch mask to the supplied bit-pattern. The number of least significant bits corresponding
to the size of the sub-unit are written into the mask. A '1' bit in the mask disables the corresponding switch
for the PIL_OpBit, PIL_OpCrosspoint, PIL_WriteSub and PIL_WriteSubArray 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.
| Input | ||
| Name | Type | Description |
| session | long |
Handle of current session. |
| cardNumber | unsigned long |
Card number. |
| outputSubunit | unsigned long |
Subunit number. |
| data | unsigned long [] |
Bitwise array that represents mask to be written into subunit. |
| dataLength | unsigned long |
Size of one-dimensional array containing data. |
| Name | Type | Description |
| return | unsigned long |
Zero for success, or no-zero error code. |
Mask
General purpose output
Client Bridge for LXI - Base module
Alphabetical Function Index
Hierarchical Function Index