función TSPI_lineSetCallParams (tspi.h)

Artículo
03/03/2024

La función TSPI_lineSetCallParams establece determinados parámetros para una llamada existente.

Sintaxis

LONG TSPIAPI TSPI_lineSetCallParams(
  DRV_REQUESTID          dwRequestID,
  HDRVCALL               hdCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parámetros

dwRequestID

Identificador de la solicitud asincrónica.

hdCall

Identificador de la llamada cuyos parámetros se van a cambiar. El estado de llamada puede ser cualquier estado excepto inactivo y desconectado.

dwBearerMode

Nuevo modo de portador de la llamada. El parámetro dwBearerMode solo puede tener una de las constantes LINEBEARERMODE_.

dwMinRate

Límite inferior para la nueva velocidad de datos de la llamada. TAPI puede aceptar una nueva tarifa tan baja como esta. TAPI no valida este parámetro cuando se llama a esta función.

dwMaxRate

Límite superior para la nueva velocidad de datos de la llamada. Esta es la velocidad de datos máxima que le gustaría tapi. Los valores iguales para dwMinRate y dwMaxRate indican que se requiere una velocidad de datos exacta. TAPI no valida este parámetro cuando se llama a esta función.

lpDialParams

Puntero a los nuevos parámetros de marcado para la llamada, de tipo LINEDIALPARAMS. Si este parámetro es NULL, indica que se van a usar los parámetros de marcado actuales de la llamada.

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_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_NOMEM, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALRATE, LINEERR_RESOURCEUNAVAIL, LINEERR_BEARERMODEUNAVAIL.

Comentarios

Esta operación se usa para cambiar los parámetros de una llamada existente. Algunos ejemplos de su uso incluyen cambiar el modo de portador o la velocidad de datos de una llamada existente.