Version

Appendix A

Error Summary

: Introduction
: Alphabetical Error Summary
: Numerical Error Summary

Introduction

This appendix provides a summary of the Switching service error codes. The error codes are presented in two tables: Alphabetically by error code name, including a description of the problem and a possible solution Numerically by hex number, decimal number, and error name.
All CT Access functions return a status code. If the return code is not SUCCESS (0), it is an error code indicating that the function has failed and the reason for the failure.
Switching service error codes are defined in the include file swidef.h. The error codes are prefixed with SWIERR.

Alphabetical Error Summary

The following table is an alphabetical listing of Switching service errors. All errors are 32 bits.

Error Name

Hex

Decimal

Description

SWIERR_CONNECTION_NOT_
SUPPORTED

0x40011

262161

The switch block does not support the requested connection. There is a permanent limitation in the switch block that prevents the connection.

SWIERR_DEVICE_ERROR

0x40002

262146

The MVIP device driver encountered an error while using the services of another device driver.

SWIERR_DLL_INVALID_DEVICE

0x40001

262145

The Dynamic Link Library (DLL) could not find the requested device.

SWIERR_INTERNAL_CONFLICT

0x40010

262160

A switch component of a switch matrix conflicts with another switch component (the state of the switch matrix is ambiguous).

SWIERR_INVALID_CLOCK_PARM

0x40007

262151

The value of a clock configuration parameter is invalid. Enter a valid value.

SWIERR_INVALID_COMMAND

0x40000

262144

The device driver does not support the requested operation.

SWIERR_INVALID_MINOR_SWITCH

0x4000B

262155

The value of the switch parameter is invalid.

SWIERR_INVALID_MODE

0x4000A

262154

The device driver does not support the setting of the mode of an output terminus to the mode specified (for example, swiMakeFramedConnection is not supported in all hardware or by MVIP-90 drivers).
Enter a valid mode. If you are using swiMakeFramedConnection on a board with the H.100 or H.110 bus, ensure that the statement SwitchConnectMode = AllConstantDelay is present in the board keyword file.

SWIERR_INVALID_PARAMETER

0x4000C

262156

The parameter needed by the called function is set to an invalid value. Enter a valid value.

SWIERR_INVALID_SPEED

0x40008

262152

An invalid stream speed capacity was entered. This functionality only works in MVIP-95. Enter one of the following acceptable speed values:
MVIP95_2MBPS_STREAM_SPEED
MVIP95_4MBPS_STREAM_SPEED
MVIP95_8MBPS_STREAM_SPEED

SWIERR_INVALID_STREAM

0x40004

262148

The value of stream in a terminus element is out of range. Enter a valid value for stream in the terminus element.

SWIERR_INVALID_TIMESLOT

0x40005

262149

The value of timeslot in a terminus element is out of range. Enter a valid value for timeslot in the terminus element.

SWIERR_MISSING_PARAMETER

0x40006

262150

An insufficient number of parameters were provided for the driver to complete the command.

SWIERR_MVIP_BUS_NOT_ENABLED

0x40012

262162

A switching command was called on a switch block on which the MVIP bus was not enabled.
CLOCKING.HBUS.CLOCKMODE = Master_A, Master_B, or Slave in the board keyword file for the switch block.

SWIERR_NO_PATH

0x4000E

262158

The device driver is unable to complete the connection because there is blocking or some other temporary switch limitation encountered.

SWIERR_NOT_CONFIGURABLE

0x40009

262153

The device does not support configuration of the parameters and/or values requested.

SWIERR_SWITCH_VERIFY_ERROR

0x4000F

262159

Verification of the switch operation failed.

SWIERR_UNSUPPORTED_MODE

0x4000D

262157

The mode is not supported by either the device driver or the hardware below the driver.

Error Name	Hex	Decimal	Description
SWIERR_CONNECTION_NOT_ SUPPORTED	0x40011	262161	The switch block does not support the requested connection. There is a permanent limitation in the switch block that prevents the connection.
SWIERR_DEVICE_ERROR	0x40002	262146	The MVIP device driver encountered an error while using the services of another device driver.
SWIERR_DLL_INVALID_DEVICE	0x40001	262145	The Dynamic Link Library (DLL) could not find the requested device.
SWIERR_INTERNAL_CONFLICT	0x40010	262160	A switch component of a switch matrix conflicts with another switch component (the state of the switch matrix is ambiguous).
SWIERR_INVALID_CLOCK_PARM	0x40007	262151	The value of a clock configuration parameter is invalid. Enter a valid value.
SWIERR_INVALID_COMMAND	0x40000	262144	The device driver does not support the requested operation.
SWIERR_INVALID_MINOR_SWITCH	0x4000B	262155	The value of the switch parameter is invalid.
SWIERR_INVALID_MODE	0x4000A	262154	The device driver does not support the setting of the mode of an output terminus to the mode specified (for example, swiMakeFramedConnection is not supported in all hardware or by MVIP-90 drivers). Enter a valid mode. If you are using swiMakeFramedConnection on a board with the H.100 or H.110 bus, ensure that the statement `SwitchConnectMode = AllConstantDelay` is present in the board keyword file.
SWIERR_INVALID_PARAMETER	0x4000C	262156	The parameter needed by the called function is set to an invalid value. Enter a valid value.
SWIERR_INVALID_SPEED	0x40008	262152	An invalid stream speed capacity was entered. This functionality only works in MVIP-95. Enter one of the following acceptable speed values: MVIP95_2MBPS_STREAM_SPEED MVIP95_4MBPS_STREAM_SPEED MVIP95_8MBPS_STREAM_SPEED
SWIERR_INVALID_STREAM	0x40004	262148	The value of stream in a terminus element is out of range. Enter a valid value for stream in the terminus element.
SWIERR_INVALID_TIMESLOT	0x40005	262149	The value of timeslot in a terminus element is out of range. Enter a valid value for timeslot in the terminus element.
SWIERR_MISSING_PARAMETER	0x40006	262150	An insufficient number of parameters were provided for the driver to complete the command.
SWIERR_MVIP_BUS_NOT_ENABLED	0x40012	262162	A switching command was called on a switch block on which the MVIP bus was not enabled. `CLOCKING.HBUS.CLOCKMODE =` Master_A, Master_B, or Slave in the board keyword file for the switch block.
SWIERR_NO_PATH	0x4000E	262158	The device driver is unable to complete the connection because there is blocking or some other temporary switch limitation encountered.
SWIERR_NOT_CONFIGURABLE	0x40009	262153	The device does not support configuration of the parameters and/or values requested.
SWIERR_SWITCH_VERIFY_ERROR	0x4000F	262159	Verification of the switch operation failed.
SWIERR_UNSUPPORTED_MODE	0x4000D	262157	The mode is not supported by either the device driver or the hardware below the driver.

Numerical Error Summary

The following table is a list of CT Access Switching service errors in numerical order: Hex Decimal Error Name 0x40000 262144 SWIERR_INVALID_COMMAND 0x40001 262145 SWIERR_DLL_INVALID_DEVICE 0x40002 262146 SWIERR_DEVICE_ERROR 0x40004 262148 SWIERR_INVALID_STREAM 0x40005 262149 SWIERR_INVALID_TIMESLOT 0x40006 262150 SWIERR_MISSING_PARAMETER 0x40007 262151 SWIERR_INVALID_CLOCK_PARM 0x40008 262152 SWIERR_INVALID_SPEED 0x40009 262153 SWIERR_NOT_CONFIGURABLE 0x4000A 262154 SWIERR_INVALID_MODE 0x4000B 262155 SWIERR_INVALID_MINOR_SWITCH 0x4000C 262156 SWIERR_INVALID_PARAMETER 0x4000D 262157 SWIERR_UNSUPPORTED_MODE 0x4000E 262158 SWIERR_NO_PATH 0x4000F 262159 SWIERR_SWITCH_VERIFY_ERROR 0x40010 262160 SWIERR_INTERNAL_CONFLICT 0x40011 262161 SWIERR_CONNECTION_NOT_SUPPORTED 0x40012 262162 SWIERR_MVIP_BUS_NOT_ENABLED 0x40013 262163 SWIERR_UNKNOWN_ERROR

Hex	Decimal	Error Name
0x40000	262144	SWIERR_INVALID_COMMAND
0x40001	262145	SWIERR_DLL_INVALID_DEVICE
0x40002	262146	SWIERR_DEVICE_ERROR
0x40004	262148	SWIERR_INVALID_STREAM
0x40005	262149	SWIERR_INVALID_TIMESLOT
0x40006	262150	SWIERR_MISSING_PARAMETER
0x40007	262151	SWIERR_INVALID_CLOCK_PARM
0x40008	262152	SWIERR_INVALID_SPEED
0x40009	262153	SWIERR_NOT_CONFIGURABLE
0x4000A	262154	SWIERR_INVALID_MODE
0x4000B	262155	SWIERR_INVALID_MINOR_SWITCH
0x4000C	262156	SWIERR_INVALID_PARAMETER
0x4000D	262157	SWIERR_UNSUPPORTED_MODE
0x4000E	262158	SWIERR_NO_PATH
0x4000F	262159	SWIERR_SWITCH_VERIFY_ERROR
0x40010	262160	SWIERR_INTERNAL_CONFLICT
0x40011	262161	SWIERR_CONNECTION_NOT_SUPPORTED
0x40012	262162	SWIERR_MVIP_BUS_NOT_ENABLED
0x40013	262163	SWIERR_UNKNOWN_ERROR

Version

Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com