TSPI_lineAddToConference 函数 (tspi.h)

项目
03/13/2024

TSPI_lineAddToConference 函数将 hdConsultCall 指定的呼叫添加到 hdConfCall 指定的电话会议中。

语法

LONG TSPIAPI TSPI_lineAddToConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdConfCall,
  HDRVCALL      hdConsultCall
);

参数

dwRequestID

异步请求的标识符。

hdConfCall

电话会议句柄。 hdConfCall 的调用状态可以是 onHoldPendingConference 或 onHold。

hdConsultCall

要添加到会议呼叫的呼叫的句柄。此呼叫不能是另一个会议的父级或任何会议的参与者。根据 LINEADDRESSCAPS 中指示的设备功能， hdConsultCall 参数不一定是使用 TSPI_lineSetupConference 或 TSPI_linePrepareAddToConference建立的。 hdConsultCall 的调用状态可以是连接、OnHold、继续或回拨。

返回值

如果发生错误，则返回 dwRequestID 或错误号。如果函数成功，则相应ASYNC_COMPLETION的 lResult 实际参数为零;如果发生错误，则为错误号。可能的返回值如下所示：

LINEERR_INVALCALLHANDLE、LINEERR_OPERATIONUNAVAIL、LINEERR_INVALCALLSTATE、LINEERR_OPERATIONFAILED、LINEERR_CONFERENCEFULL、LINEERR_RESOURCEUNAVAIL、LINEERR_NOMEM。

注解

如果 hdConsultCall 是另一个会议的父级或已是会议的参与者，或者由于其他原因而无法添加 hdConsultCall，例如必须使用TSPI_lineSetupConference或TSPI_linePrepareAddToConference建立 hdConsultCall，则服务提供商将返回LINEERR_INVALCALLHANDLE。

注意将呼叫添加到会议后，添加方呼叫句柄保持有效;通常，当会议呼叫的状态变为连接时，其状态将更改为“已会议”。单个参与呼叫的句柄稍后可用于使用 TSPI_lineRemoveFromConference 从会议呼叫中删除该参与方。

参与会议的呼叫的呼叫状态不独立。例如，在拨打电话会议时，所有参与的呼叫都可以自动变为 空闲状态。 TAPI 可以咨询线路的设备功能，以确定可用的会议删除形式。 TAPI 或其客户端应用程序应跟踪 LINE_CALLSTATE 消息，以确定涉及的调用发生的情况。

电话会议通过 TSPI_lineSetupConference 或 TSPI_lineCompleteTransfer建立。通常，添加到会议的呼叫是使用 TSPI_lineSetupConference 或 TSPI_linePrepareAddToConference建立的。某些开关可能允许向会议添加任意呼叫，并且此类呼叫可能是使用 TSPI_lineMakeCall 设置的，并且 (难以) 保留。作为会议一部分的所有呼叫必须位于同一条开放行上。

会议呼叫上的任何监视 (媒体、音调、数字) 仅适用于 hdConfCall 参数，不适用于单个参与呼叫。

此函数没有基于权限的限制，就像 TAPI 级别的相应函数一样。服务提供商没有明确要求跟踪“父”电话会议与其参与者之间的关系，因为 TSPI 与 TAPI 函数没有对应关系。许多服务提供商可能发现有必要在内部跟踪这些关系，以实现其他会议呼叫管理功能。