Disconnects a media channel between two MSPP endpoints.

DWORD mspDisconnect (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_HANDLE
  The specified MSPP endpoint/channel is not valid.
• MSPERR_INTERNAL_HANDLE
  The specified MSPP endpoint/channel is not valid.
• MSPERR_INVALID_CONNECTION
  The specified MSPP connection cannot be found.
• MSPERR_DRIVER_COMMAND_FAILED
  An SPI command has failed.
• MSPERR_CHANNEL_NOT_CONNECTED
  The specified MSPP channel is not connected to any endpoints.

• MSPEVN_DISCONNECT_DONE
  Generated when an MSPP channel is disconnected from two endpoints in response to an mspDisconnect function call. The event.value field can contain the following:
• SUCCESS
• MSPRSN_FAILED_TO_DEALLOCATE
  The MSPP service is unable to deallocate on-board
  resources.
• MSPRSN_FAILED_TO_INTRADISCONNECT
  The MSPP service is unable to disconnect filters
  within the channel.
• MSPRSN_FAILED_TO_INTERDISCONNECT
  The MSPP service was unable to disconnect the
  channel from an endpoint.

When called, mspDisconnect disassociates the MSPP endpoints and MSPP channel in a specified connection. For example, in the case of voice channels, ephd1 must point to an RTP endpoint and ephd2 must point to a DS0 endpoint. In the case of fax channels, ephd1 must point to a UDP endpoint (for fax) and ephd2 must point to a DS0 endpoint. The channel and endpoints should be disabled (using the mspDisableChannel and mspDisableEndpoint primitives) before mspDisconnect is called.

Note: Endpoints must be specified in the same order as they were when mspConnect was called.

mspConnect

ret = mspDisconnect( hEp1, hChan, hEp2);
if (ret != SUCCESS)
    return FAILURE;
// Wait for event
ctaWaitEvent( hCta, &Event, CTA_WAIT_FOREVER );
// Check the reason code
if ( Event.id    != MSPEVN_DISCONNECT_DONE ||
     Event.value != CTA_REASON_FINISHED )
    return FAILURE;