Connects a media channel between two endpoints.

DWORD mspConnect (MSPHD ephd1,
MSPHD chnhd,
MSPHD ephd2)

ephd1 First MSPP endpoint handle.

chnhd MSPP channel handle.

ephd2 Second MSPP endpoint handle.

• SUCCESS
• CTAERR_BAD_ARGUMENT
  The function argument had an invalid value or a required pointer argument was NULL.
• CTAERR_INVALID_CTAHD
  The CTA context handle is invalid.
• CTAERR_INVALID_HANDLE
  An invalid handle was passed as an argument to this function.
• MSPERR_INVALID_CONNECTION
  The specified MSPP connection cannot be found.
• MSPERR_INTERNAL_HANDLE
  The specified MSPP endpoint/channel is not valid.
• MSPERR_DRIVER_COMMAND_FAILED
  An SPI command failed.
• MSPERR_INVALID_HANDLE
  The specified MSPP endpoint/channel is not valid.

• MSPEVN_CONNECT_DONE
  Generated when the MSPP service connects a media channel to two endpoints in response to an mspConnect call. The event.value field can contain the following:
• SUCCESS
• MSPRSN_FAILED_TO_ALLOCATE
  The MSPP service is unable to allocate on-board
  resources.
• MSPRSN_FAILED_TO_INTRACONNECT
  The MSPP service is unable to connect filters within
  the channel.
• MSPRSN_FAILED_TO_INTERCONNECT
  The MSPP service is unable to connect the channel to
  an endpoint.

When invoking mspConnect, specify two endpoint handles and a channel handle. These specify the endpoints through which the data will flow, and the processes that will take place (for example, encoding and decoding) as the transferred data flows through a channel. The order of the endpoints in the argument list must correspond to the channel type.

For voice channels, ephd1 must be associated with an RTP endpoint and ephd2 must be associated with a DS0 endpoint. For fax channels, ephd1 must be associated with a UDP endpoint and ephd2 must be associated with a DS0 endpoint.

mspCreateChannel, mspCreateEndpoint, mspDisconnect

DWORD ret;
CTAHD                   hCtaHd[MAX_CONNECTIONS];
CTAQUEUEHD              hCtaQueue;
CTA_EVENT               Event;
MSPHD hEp1, hEp2, hChan;
ret = mspConnect(hEp1, hChan, hEp2);
if (ret != SUCCESS)
    return FAILURE;
ctaWaitEvent( hCtaQueue, &Event, CTA_WAIT_FOREVER );
if ( Event.id    != MSPEVN_CONNECT_DONE ||
     Event.value != CTA_REASON_FINISHED )
    return FAILURE;