función TSPI_linePrepareAddToConference (tspi.h)

Artículo
03/03/2024

La función TSPI_linePrepareAddToConference prepara una llamada de conferencia existente para la adición de otra entidad. Crea una nueva llamada de consulta temporal. La nueva llamada de consulta se puede agregar posteriormente a la llamada de conferencia.

Sintaxis

LONG TSPIAPI TSPI_linePrepareAddToConference(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdConfCall,
  HTAPICALL              htConsultCall,
  LPHDRVCALL             lphdConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdConfCall

Identificador de una llamada de conferencia. El estado de llamada de hdConfCall se puede conectar.

htConsultCall

El controlador TAPI para la nueva llamada de consulta temporal. El proveedor de servicios debe guardarlo y usarlo en todas las llamadas posteriores al procedimiento LINEEVENT que notifica eventos en la nueva llamada. El estado de llamada de hdAddCall no es aplicable.

lphdConsultCall

Puntero a un HDRVCALL que representa el identificador del proveedor de servicios para la nueva llamada de consulta temporal. El proveedor de servicios debe rellenar esta ubicación con su identificador para la nueva llamada antes de que este procedimiento devuelva. Este identificador no es válido si la función produce un error.

lpCallParams

Puntero a un LINECALLPARAMS que contiene parámetros de llamada que se usarán al establecer la llamada de consulta. Este parámetro se establece en NULL si no se desea ningún parámetro de configuración de llamada especial.

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 ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_CONFERENCEFULL, LINEERR_INVALRATE, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_USERUSERINFOTOOBIG.

Comentarios

El proveedor de servicios devuelve LINEERR_INVALLINESTATE si la línea no está actualmente en un estado en el que se puede realizar esta operación. El proveedor de servicios debe indicar una lista de operaciones válidas actualmente en el miembro dwLineFeatures (del tipo LINEFEATURE) en la estructura LINEDEVSTATUS .

El proveedor de servicios devuelve LINEERR_INVALCALLSTATE si la llamada de conferencia no está en un estado válido para la operación solicitada.

Esta función coloca una llamada de conferencia existente en el estado onHoldPendingConference y crea una llamada de consulta que se puede agregar más adelante a la llamada de conferencia existente con TSPI_lineAddToConference.

La llamada de consulta se puede cancelar mediante TSPI_lineDrop. También puede ser posible que TAPI intercambie entre la llamada de consulta y la llamada de conferencia celebrada con TSPI_lineSwapHold. Inicialmente, el proveedor de servicios realiza la supervisión de medios en la nueva llamada para al menos el conjunto de tipos de medios que se supervisaron en la línea.

Esta función difiere de la función TAPI correspondiente en que sigue el modelo de TSPI para comenzar la duración de una llamada. TAPI y el proveedor de servicios intercambian identificadores opacos que representan la llamada entre sí. Además, el proveedor de servicios puede realizar devoluciones de llamada para la nueva llamada antes de que vuelva de este procedimiento. En cualquier caso, el proveedor de servicios también debe tratar el identificador que devolvió como "todavía no válido" hasta después de que la coincidencia ASYNC_COMPLETION mensaje notifique que se ha realizado correctamente. En otras palabras, no debe emitir ningún mensaje LINEEVENT para la nueva llamada o incluirlo en recuentos de llamadas en mensajes o estructuras de datos de estado para la línea.