Makes simplex, duplex, or quad switch connection.

DWORD ppxConnect ( 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_NOT_FOUND
  The talker or the listener is not defined in the PPX configuration file.
• CTAERR_OUT_OF_MEMORY
  Unable to allocate memory.
• PPXERR_COMM_FAILURE
  Problems were encountered when communicating with the PPX server.
• PPXERR_DISABLED
  The switch number specified has been disabled.
• 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_LISTENER_BUSY
  The specified listener is assigned to another connection.
• PPXERR_NO_PATH
  Could not find a path from talker to the listener.
• PPXERR_NOT_LISTENER
  The listener is incapable of receiving output from the connection.
• PPXERR_NOT_TALKER
  The specified talker is incapable of driving the output for 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 is a convenience function which "wraps" the functionality of ppxCreateConnection, ppxSetTalker, and ppxAddListener. ppxConnect makes one-talker to one listener connections. These connections use internal connection handles which cannot be accessed by the application. Listeners cannot be added to connections made by ppxConnect.

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.

ppxDisconnect

DWORD MyConnect( CTAHD ctahd, PPX_CX_MODE mode )
{
    PPX_MVIP_ADDR listener, talker;
    DWORD ret ;
    
    talker.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, or PPX_QUAD
      */
               
    ret = ppxConnect( ctahd, &talker, &listener, mode );
    
    return ( ret ) ;
    
}