Returns the number of relays and list of relays numbers that failed the coil relays test for the specified device number.
CalMatrixGetDeviceFailedRelays (hHandle, lMatrixRelayTestDevice, plFailedDeviceRelays, psFailedDeviceRelaysList, plStatus)
Name |
Type |
Comments |
hHandle |
LONG |
Handle for a DMM. |
lMatrixRelayTestDevice |
LONG |
The device number that all the relays associated with will be tested, see comments section for more details. |
plFailedDeviceRelays |
PLONG |
Returns the number of relays that failed the coil relays test and are used by lMatrixRelayTestDevice. |
psFailedDeviceRelaysList |
PSTR |
If plFailedDeviceRelays is >0, it returns a list of all the relays numbers associated with the specified device that failed the coil test and their and descriptions. |
plStatus |
PLONG |
Returned status: 0 on success, negative number on failure. |
Returns the number of relays and list of relays numbers that failed the coil relays test and are used by the specified device number.
lMatrixRelayTestDevice:
100.aCalMatrixCoilTestDio0: Matrix relays associated with DIO number 0 in the system
101.aCalMatrixCoilTestDio1: Matrix relays associated with DIO number 1 in the system
102.aCalMatrixCoilTestDio2: Matrix relays associated with DIO number 2 in the system
103.aCalMatrixCoilTestDio3: Matrix relays associated with DIO number 3 in the system
104.aCalMatrixCoilTestDio4: Matrix relays associated with DIO number 4 in the system
105.aCalMatrixCoilTestDio5: Matrix relays associated with DIO number 5 in the system
106.aCalMatrixCoilTestDio6: Matrix relays associated with DIO number 6 in the system
107.aCalMatrixCoilTestDio7: Matrix relays associated with DIO number 7 in the system
108.aCalMatrixCoilTestSmu0: Matrix relays associated with SMU number 0 in the system
109.aCalMatrixCoilTestSmu1: Matrix relays associated with SMU number 1 in the system
110.aCalMatrixCoilTestSmu2: Matrix relays associated with SMU number 2 in the system
111.aCalMatrixCoilTestSmu3: Matrix relays associated with SMU number 3 in the system
112.aCalMatrixCoilTestSmu4: Matrix relays associated with SMU number 4 in the system
113.aCalMatrixCoilTestSmu5: Matrix relays associated with SMU number 5 in the system
114.aCalMatrixCoilTestDps0: Matrix relays associated with DPS number 0 in the system
115.aCalMatrixCoilTestDps1: Matrix relays associated with DPS number 1 in the system
116.aCalMatrixCoilTestDps2: Matrix relays associated with DPS number 2 in the system
199.aCalMatrixCoilTestMeasurementDmm: Matrix relays associated with the measurement DMM
Note: This function supported only by the CalMatrixTS9xx.dll driver.This function supported only by the CalMatrixTS9xx.dll driver.
The following example returns relay’s number 0 coil test status and
description:
LONG hHandle, lFailedDeviceRelays, lStatus;
CHAR szDescriptionAndStatus [256];
CalMatrixGetDeviceFailedRelay (hHandle, 0, szDescriptionAndStatus, &lStatus);
printf(“Relay #0:%s”, szDescriptionAndStatus);