Disconnects an existing simplex, duplex, or quad connection.

DWORD ppxDisconnect ( CTAHD ctahd,
PPX_MVIP_ADDR *talker,
PPX_MVIP_ADDR *listener,
PPX_CX_MODE mode )

ctahd CTA context handle returned by ctaCreateContext.

talker Pointer to a PPX_MVIP_ADDR structure. The structure is defined as follows:

typedef struct
{
 DWORD switch_number;
 DWORD bus;      
 DWORD stream;     
 DWORD timeslot;    
} PPX_MVIP_ADDR

See the Details section for a description of these fields.

listener Pointer to a PPX_MVIP_ADDR structure.

mode Connection mode: PPX_SIMPLEX,
PPX_DUPLEX, or PPX_QUAD.

• SUCCESS
• CTAERR_DRIVER_ERROR
  The underlying driver retrieved an unrecognized error. Call swiGetLastError to retrieve the MVIP device error code.
• CTAERR_INVALID_HANDLE
  ctahd is not a valid CTA context handle.
• CTAERR_NOT_FOUND
  The talker or the listener is not defined in the Point-to-Point Switching configuration file.
• CTAERR_OUT_OF_MEMORY
  Unable to allocate memory.
• PPXERR_COMM_FAILURE
  Problems were encountered when communicating with the PPX server.
• PPXERR_CONN_OWNERSHIP
  The listener is in a connection not owned by the calling connection or the initial connection was nailed up.
• PPXERR_DRIVER_OPEN_FAILED
  The driver open failed, or the driver DLL or device was not found.
• PPXERR_INVALID_SWITCH
  Switch number specified is inaccessible from the specified bus:stream:timelslot.
• PPXERR_NOT_CONNECTED
  The listener is not receiving output from the talker.
• PPXERR_NOT_LISTENER
  The listener is incapable of receiving output from the connection.
• 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 disconnects a talker from a listener which was previously connected via ppxConnect. Any intervening timeslots are freed.

The CTA context must "own" the connection in order to disconnect.

If talker = NULL, the listener will be disconnected (output disabled).

ppxDisconnect may also be used to disconnect any nailed up connections specified in the Point-to-Point Switching configuration file as long as the connections were not specified with the NAILED keyword. Ensure that no application is using the connection before disconnecting.

The PPX_MVIP_ADDR structure contains the following fields:

Field	Description
switch_number	Switch number of the board as defined in ppx.cfg
bus	Acceptable values are: MVIP95_MVIP_BUS MVIP95_LOCAL_BUS MVIP95_MC1_BUS
stream	The stream number of the listener/talker.
timeslot	The timeslot of the listener/talker.

ppxConnect, ppxRestoreConnections

DWORD MyConnectDisconnect( CTAHD ctahd, PPX_CX_MODE mode, BOOL MakeConn )
{
    PPX_MVIP_ADDR listener, talker;
    DWORD ret ;
    
    talkers.switch_number =0;
    talker.bus = MVIP95_LOCAL_BUS;
    talker.stream = 0;
    talker.timeslot = 4;
 
    listener.switch_number = 1 ;
    listener.bus = MVIP95_LOCAL_BUS;
    listener.stream = 5;
    listener.timeslot = 4;
    
     /*
      * The passed in "mode" has one of the following
      * values:
      *    PPX_SIMPLEX, PPX_DUPLEX, PPX_QUAD
      */
    if ( MakeConn == TRUE )
   
       ret = ppxConnect( ctahd, &talker, &listener, mode );
    
    else
    
       ret = ppxDisconnect( ctahd, &listener, &talker, mode );
    
   return ( ret ) ;
}