Opens a switching device and returns a switch handle.

DWORD swiOpenSwitch ( CTAHD ctahd,
char *devname,
unsigned swno,
unsigned flags,
SWIHD *swihd)

ctahd Handle returned by ctaCreateContext.

devname Pointer to the base name of the switching device, for example, agsw.

swno Switch number relative to the switch type.

flags Flags for the open call. Refer to the Details section.

swihd Pointer to the returned switch handle.

• SUCCESS
• CTAERR_DRIVER_OPEN_FAILED
  The driver open failed. Refer to the board installation manual.
• CTAERR_NOT_FOUND
  The driver dynamic link library or the device was not found. Refer to the board installation manual.
• CTAERR_INVALID_CTAHD
  The ctahd referenced by swihd is invalid.

• None.

This function opens a switching device and returns a handle to the switch block for use in subsequent switching calls.

swno is the board number of the board within a specific switching device type.

For example, you have a system with two CG 6000C boards and one CX 2000 board. The CG 6000C boards use the devname agsw. The CX 2000 board uses the devname cxsw.

The swno passed to swiOpenSwitch for the CG 6000C board and the CX 2000 board is the logical number assigned to the board.

Caution:

Since MVIP-95 device drivers can be opened only in MVIP-95 mode, it is recommended that all applications that may use MVIP-95 device drivers in the future be written to use MVIP-95 mode, even if the application is not currently using MVIP-95 device drivers.

The SWI_ENABLE_RESTORE bit is used to save the state of the switch block outputs so that the state of the switch block outputs can be restored when it is closed using swiCloseSwitch.

Acceptable values for flags are:

• Zero (0). The switch is opened in MVIP-95 mode and restoration is disabled.

• SWI_ENABLE_RESTORE

• SWI_ENABLE_ RESTORE | SWI_MVIP90

Refer to Section 3.2, Opening a Switch Handle for more information.

If CTAERR_DRIVER_ERROR is returned, call swiGetLastError to retrieve the MVIP device error code.

swiCloseSwitch, swiGetLastError

void myApplicationInit(CTAHD ctahd, SWIHD hd[], int count)
{
    int i;

    for (i = 0; i < count; i++)
    {
        swiOpenSwitch(ctahd, "agsw", i, SWI_ENABLE_RESTORE, &hd[i]);
    }

}