Connects inputs to outputs.

DWORD swiMakeConnection ( SWIHD swihd,
SWI_TERMINUS input[],
SWI_TERMINUS output[],
unsigned count)

swihd Handle returned by swiOpenSwitch.

input Array of terminus structures for the input side of the connection. The terminus structure is:

typedef struct
{
 DWORD bus;
 DWORD stream;
 DWORD timeslot; 
} SWI_TERMINUS;

See the Details section for a description of these fields.

output Array of terminus structures for the output side of the connection.

count Number of elements in the input array and in the output array.

• SUCCESS
• CTAERR_DRIVER_ERROR
  The underlying driver retrieved an unrecognized error. Call swiGetLastError to retrieve the MVIP device error code.
• CTAERR_INVALID_HANDLE
  swihd is not a valid switch handle.
• SWIERR_INVALID_STREAM
  One or more of the streams specified is invalid.
• SWIERR_INVALID_TIMESLOT
  One or more of the timeslots specified is invalid.

• None.

This function makes connections between the corresponding elements of the output terminus array and the input terminus array.

If multiple connections are made (that is, count is greater than 1), the relative throughput delay of the connections may not all be the same. Use swiMakeFramedConnection if you need identical throughput delays.

Note: Under Solaris, the upper limit for the number of terminuses that can be batched in one call is 32.

The SWI_TERMINUS structure contains the following fields:

Field	Description
bus	Specifies the interface point of the switch block. Devices can reside directly on the MVIP bus. Devices can also reside on a board's local bus and may require a switch block to access the MVIP bus. Acceptable bus values are: MVIP95_MVIP_BUS MVIP95_LOCAL_BUS
stream	A grouping of timeslots that usually corresponds to a particular bit stream of time-division multiplexed (TDM) serial data on an individual track or wire of a bus.
timeslot	Specifies a particular 64 kbit/s subdivision of a TDM bus stream. Timeslots number from zero (0) to n where n is stream-dependent.

Note: It is important to disable an output when the connection or pattern is no longer required. Leftover connections or patterns can cause unpredictable behavior in the application.

Refer to Section 5.2, Making Connections for more information.

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

swiDisableOutput, swiGetLastError, swiGetOutputState, swiGetSwitchCaps, swiMakeFramedConnection, swiResetSwitch, swiSampleInput, swiSendPattern

Note: Refer to Section 2.2.3, MVIP-95 Switch Block Model for information about stream numbering when making duplex connections or QUAD connections.

#define SIMPLEX 0
#define DUPLEX  1
void myMakeConnection(SWIHD hd, SWI_TERMINUS input, SWI_TERMINUS output, 
                      unsigned count, DWORD mode)
{
    unsigned i;
    DWORD duplex = 0;
    SWI_TERMINUS *outputs, *inputs;

    if (mode == DUPLEX)
        duplex = 1;

    inputs = (SWI_TERMINUS *)malloc(sizeof(SWI_TERMINUS)*count);
    outputs = (SWI_TERMINUS *)malloc(sizeof(SWI_TERMINUS)*count);

    for (i = 0; i < count; i++)
    {
        inputs[i].bus = input.bus;
        inputs[i].stream = input.stream;
        inputs[i].timeslot = input.timeslot + i;

        outputs[i].bus = output.bus;
        outputs[i].stream = output.stream;
        outputs[i].timeslot = output.timeslot + i;
    }
    swiMakeConnection(hd, inputs, outputs, count);

    if( duplex )
    {
        for (i = 0; i < count; i++)
        {
            inputs[i].stream = inputs[i].stream + 1;
            outputs[i].stream = outputs[i].stream - 1;
        }
        swiMakeConnection(hd, outputs, inputs, count);
    }
}