niSwitch_GetRelayCount
Specific Function
C Function Prototype
ViStatus niSwitch_GetRelayCount (ViSession vi, ViConstString relayName, ViInt32* relayCount);
Purpose
Returns the number of times the relay has changed from closed to open. Relay count is useful for tracking relay lifetime and usage. Call niSwitch_WaitForDebounce before niSwitch_GetRelayCount to ensure an accurate count.
Refer to Devices to determine if the switch module supports individual relay control.
Parameters
| Name | Type | Description |
|---|---|---|
| vi | ViSession | A particular NI-SWITCH session established with niSwitch_InitWithTopology, niSwitch_InitWithOptions, or niSwitch_init and used for all subsequent NI-SWITCH calls. |
| relayName | ViConstString | Name of the relay. Refer to Devices for a list of valid relay names for the switch module. Examples of valid relay names: ch0, ab0, 1wire, hlselect |
| relayCount | ViInt32 | The number of relay cycles. |