Returns the relay count associated with all the relays on the specified device.
Gx6188GetRelayCount (nHandle, padwRelayCount, pnMaxLen, pnStatus)
Name |
Type |
Comments |
nHandle |
SHORT |
Handle to a GX6188 board. |
padwRelayCount |
PDWORD |
Returns an array containing each relay's cumulative open/close count. |
pnMaxLen |
PSHORT |
Size of the array passed into the padwRelayCount parameterThe function returns the actual number of elements written to the array in this variable as well. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
Each board contains many relays. Whenever each relay is opened or closed, the count for the specific relays is incremented and then stored on an onboard EEPROM.
Each element in the relay count array, padwRelayCount, represents the total number of open/close events for the lifetime of a relay. The element index corresponds with the relay designation number minus one. For example, element 0 in the array contains the relay count for the relay designated "K1", element 1 in the array contains the relay count for the relay designated "K2", and so on.
The following example returns the relay count for relay K200 on a rear transition board that is connected to slot 5:
SHORT nHandle, nStatus, nMaxRelay;
DWORD adwRelayCount[256];
nMaxRelay=256;
Gx6188Initialize (5, &nHandle, &nStatus);
Gx6188GetRelayCount (nHandle, adwRelayCount, &nMaxRelay, &nStatus);
printf("Relay K200 has been opened/closed %d times.", adwRelayCount[199]);