View Crosspoint

Description

Obtains the state of an individual matrix crosspoint.

Prototype

DWORD PIPLX_ViewCrosspoint(SESSION session, DWORD CardNum, DWORD OutSub, DWORD Row, DWORD Column, BOOL *State);

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

State - pointer to variable to receive the result (0 = OFF, 1 = ON)

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_ViewBit. It offers more straightforward matrix operation, and avoids the need for re-coding if a matrix card is replaced by one having different dimensions.