Sets a talker for a connection.

DWORD ppxSetTalker ( PPXHD ppxhd,
PPX_MVIP_ADDR *talker )

ppxhd Handle returned by ppxCreateConnection or by ppxOpenConnection.

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.

• SUCCESS
• CTAERR_DRIVER_ERROR
  The underlying driver retrieved an unrecognized error. Call swiGetLastError to retrieve the MVIP device error code.
• CTAERR_INVALID_HANDLE
  ppxhd is not a valid connection handle.
• CTAERR_NOT_FOUND
  The talker 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_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_NO_PATH
  Could not find a path from talker to one of the listeners assigned to 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 function sets the talker for a connection. If the connection has listeners attached, a switch connection is made to connect the listeners to the talker. If the talker and listeners are on different boards, telephony bus timeslots are allocated to make the connection.

If there was a talker already attached to the connection, the original talker is disconnected before the new talker is connected. Any unused timeslots are freed.

Specifying talker = NULL removes any previous talker to the connection. Any timeslots will be freed and the listeners receive the default pattern.

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 talker.
timeslot	The timeslot of the talker.

ppxAddListeners

void WhileTheyWait( MYCONTEXT *cx ) 
{
    DWORD e;
    char  ppxname [20];

    DemoStartProtocol( cx->hd, cx->protocol, NULL, NULL );  
    
    /* Allocate a connection */
    sprintf( ppxname, "ppxdemo%01d", cx->id );
    e = ppxCreateConnection( cx->hd, ppxname, &ppx_parms, 
                                   &(ppxhd[cx->id]) );
    if (e != SUCCESS)
    {
        printf("Unable to create a connection ; returns: %d\n",e);
        exit(-1);
    }
    
    /*
     * Set this port as the talker on this "Please hold...will try
     * that extension now" connection
     */    
    talkers[cx->id].switch_number = cx->swi;
    talkers[cx->id].bus = MVIP95_LOCAL_BUS;
    talkers[cx->id].stream = dsp_stream;
    talkers[cx->id].timeslot = cx->time_slot; 
                
    e = ppxSetTalker( ppxhd[cx->id], &talkers[cx->id] );         
    if( e != SUCCESS )
    {
        printf("Could not set talker\n");
        exit(-1);
    }