Makes a direct call to the MVIP device driver.

DWORD swiCallDriver ( SWIHD swihd,
DWORD command,
DWORD *args,
DWORD size,
DWORD *errorcode)

swihd Handle returned by swiOpenSwitch.

command MVIP driver command to call.

args Pointer to the arguments to the driver call.

size Size, in bytes, of the arguments to the driver call.

errorcode Pointer to the device driver return code.

• SUCCESS
• CTAERR_INVALID_HANDLE
  swihd is not a valid switch handle.
• SWIERR_CONNECTION_NOT_SUPPORTED
  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
  The MVIP device driver encountered an error while using the services of another device driver.
• SWIERR_DLL_INVALID_DEVICE
  The Dynamic Link Library (DLL) could not find the requested device.
• SWIERR_INTERNAL_CONFLICT
  A switch component of a switch matrix conflicts with another switch component. (The state of the switch matrix is ambiguous.)
• SWIERR_INVALID_CLOCK_PARM
  The value of a clock configuration parameter is invalid.
• SWIERR_INVALID_COMMAND
  The device driver does not support the requested operation.
• SWIERR_INVALID_MINOR_SWITCH
  The value of the switch parameter is invalid.
• SWIERR_INVALID_MODE
  The value of the mode parameter is incorrect or the device driver does not support the mode.
• SWIERR_INVALID_PARAMETER
  The value of a parameter which does not have its own error code is invalid.
• SWIERR_INVALID_SPEED
  The value of the speed parameter is out of range.
• SWIERR_INVALID_STREAM
  The value of the stream parameter is out of range.
• SWIERR_INVALID_TIMESLOT
  The value of the timeslot parameter is out of range.
• SWIERR_MISSING_PARAMETER
  An insufficient number of parameters were provided for the driver to complete the command.
• SWIERR_MVIP_BUS_NOT_ENABLED
  A switching command was called on a switch block on which the MVIP bus was not enabled.
• SWIERR_NO_PATH
  The device driver is unable to complete the connection because there is blocking or some other temporary switch limitation encountered.
• SWIERR_NOT_CONFIGURABLE
  The device does not support configuration of the parameters and/or values requested.
• SWIERR_SWITCH_VERIFY_ERROR
  Verification of the switch operation failed.
• SWIERR_UNSUPPORTED_MODE
  The mode is not supported by either the device driver or the hardware below the driver.

• None.

This function is an escape mechanism that provides the application with a way to make a direct call to the underlying MVIP device driver. The error codes returned by the device driver are returned to the application in the errorcode argument.

This function does not do any error checking on the parameters or on the MVIP command code. Elements affected by this function will not be restored even if the SWI_ENABLE_RESTORE flag was set in swiOpenSwitch.

Note: All commands to the drivers are synchronous, that is, they do not return until the driver has completed the command. Some functions take a long time to return. When this happens, all other activity on the CTA context is blocked until the function returns. It is advisable to create a new thread, a new CTA context, and a new switch handle if a blocking function is to be used on a switch handle.

Refer to Section 7.3, Calling the MVIP Device Driver for more information.

For more information about the MVIP driver command, refer to the MVIP-95 Device Driver Standard Manual or the MVIP-90 Standard Manual (for MVIP-90 commands).

swiOpenSwitch

/* Supervision Monitoring using MVIP-90 Driver Extensions */
int MonitorSupervision(SWIHD hd)
{
    struct start_supv_parms supvparms;
    struct wait_supv_parms waitparms;
    LONG SupvId;
    DWORD errorcode;

    /* Enable supervision on signalling stream 17, timeslot 0 (MVIP-90) */
    supvparms.stream = 17;
    supvparms.slot = 0;

    /* Wait for hangup */
    supvparms.target_pattern = SWI_A_BIT_OFF;

    /* Assert hangup from our side */
    supvparms.output_pattern = SWI_A_BIT_OFF + SWI_B_BIT_OFF;
    supvparms.qualify_time = 100;

    /* Use MVIP-90 supervision monitoring command */
    swiCallDriver(hd, START_SUPV, (void *)&supvparms, 
                  sizeof(supvparms), &errorcode);
    if (errorcode != SUCCESS)
    {
        fprintf(stderr, "** MVIP driver error code: %d\n", errorcode);
        return -1;
    }

    SupvId = supvparms.handle_ret;
    
    /* Wait until target condition is detected, no time limit on wait */
    waitparms.handle = SupvId;
    waitparms.timeout = -1L;

    /* Use MVIP-90 supervision monitoring command */
    swiCallDriver(hd, WAIT_SUPV, (void *)&waitparms, 
                  sizeof(waitparms), &errorcode);
    if (errorcode != SUCCESS)
    {
        fprintf(stderr, "** MVIP driver error code: %d\n", errorcode);
        return -1;
    }
    return 0;
}