TSPI_lineAddToConference función (tspi.h)

Artículo
08/26/2023

La función TSPI_lineAddToConference agrega la llamada especificada por hdConsultCall a la llamada de conferencia especificada por hdConfCall.

Sintaxis

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

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdConfCall

Identificador de la llamada de conferencia. El estado de llamada de hdConfCall puede ser onHoldPendingConference o onHold.

hdConsultCall

Identificador de la llamada que se va a agregar a la llamada de conferencia. Esta llamada no puede ser un padre de otra conferencia o un participante en ninguna conferencia. Según las funcionalidades del dispositivo indicadas en LINEADDRESSCAPS, es posible que el parámetro hdConsultCall no se haya establecido necesariamente mediante TSPI_lineSetupConference o TSPI_linePrepareAddToConference. El estado de llamada de hdConsultCall se puede conectar, onHold, continuar o ringback.

Valor devuelto

Devuelve dwRequestID o un número de error si se produce un error. El parámetro real lResult del ASYNC_COMPLETION correspondiente es cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_CONFERENCEFULL, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Comentarios

El proveedor de servicios devuelve LINEERR_INVALCALLHANDLE si hdConsultCall es un elemento primario de otra conferencia o ya un participante en una conferencia, o hdConsultCall no se puede agregar por otros motivos, como debe haberse establecido mediante TSPI_lineSetupConference o TSPI_linePrepareAddToConference.

Nota El identificador de llamada de la entidad agregada sigue siendo válido después de agregar la llamada a una conferencia; normalmente, su estado cambia a conferenciado mientras el estado de la llamada de conferencia se conecta. El identificador de una llamada participante individual se puede usar más adelante para quitar esa parte de la llamada de conferencia mediante TSPI_lineRemoveFromConference.

Los estados de llamada de las llamadas que participan en una conferencia no son independientes. Por ejemplo, al quitar una llamada de conferencia, todas las llamadas participantes pueden volverse inactivas automáticamente. TAPI puede consultar las funcionalidades del dispositivo de la línea para determinar qué forma de eliminación de conferencia está disponible. TAPI o sus aplicaciones cliente deben realizar un seguimiento de los mensajes de LINE_CALLSTATE para determinar qué ha ocurrido con las llamadas implicadas.

La llamada de conferencia se establece a través de TSPI_lineSetupConference o TSPI_lineCompleteTransfer. Normalmente, la llamada agregada a una conferencia se establece mediante TSPI_lineSetupConference o TSPI_linePrepareAddToConference. Algunos modificadores pueden permitir la adición de una llamada arbitraria a la conferencia, y tal llamada puede haberse configurado con TSPI_lineMakeCall y estar en suspensión (dura). Todas las llamadas que forman parte de una conferencia deben existir en la misma línea abierta.

Cualquier supervisión (multimedia, tonos, dígitos) en una llamada de conferencia solo se aplica al parámetro hdConfCall , no a las llamadas participantes individuales.

Esta función no tiene restricciones basadas en privilegios como en la función correspondiente en el nivel tapi. No hay ningún requisito explícito para que el proveedor de servicios realice un seguimiento de las relaciones entre la llamada de conferencia "principal" y sus participantes, ya que no hay correspondencia de TSPI con la función TAPI. Muchos proveedores de servicios pueden encontrar que es necesario realizar un seguimiento interno de estas relaciones para implementar las otras funciones de administración de llamadas de conferencia.