Resets the entire switch block to the idle state.
DWORD swiResetSwitch ( SWIHD swihd)
Argument |
Description |
swihd |
Return value |
Description |
SUCCESS |
|
CTAERR_DRIVER_ERROR |
Underlying driver retrieved an unrecognized error. Call swiGetLastError to retrieve the MVIP device error code. |
CTAERR_FUNCTION_NOT_AVAIL |
Reset switch was called on a switch that was opened in restore mode. |
CTAERR_INVALID_HANDLE |
swihd is not a valid switch handle. |
CTAERR_SVR_COMM |
Communication error in the server environment. |
swiResetSwitch resets the entire switch block to the idle state. All the timeslots on the MVIP bus are set to a high impedance state. The timeslots on the local bus are set to a known state. (The driver vendor must publish these states in customer documentation.)
If the switch handle was opened with the SWI_ENABLE_RESTORE flag specified in swiOpenSwitch, this function returns CTAERR_FUNCTION_NOT_AVAIL and does not affect the switch block.
Refer to Enabling terminus output state restoration for more information.
If CTAERR_DRIVER_ERROR is returned, call swiGetLastError to retrieve the MVIP device error code.
Note: This function does not alter the state of the clocks.
extern SWIHD hd;
void myAppInit(CTAHD ctahd)
{
/* Open the Switch */
swiOpenSwitch(ctahd, "AGSW", 0, 0, &hd);
/* Reset the Switch to defaults */
swiResetSwitch(hd);
}