Función lineSetCallParams (tapi.h)

Artículo
08/26/2023

La función lineSetCallParams permite a una aplicación cambiar el modo de portador o los parámetros de velocidad de una llamada existente.

Sintaxis

LONG lineSetCallParams(
  HCALL                  hCall,
  DWORD                  dwBearerMode,
  DWORD                  dwMinRate,
  DWORD                  dwMaxRate,
  LPLINEDIALPARAMS const lpDialParams
);

Parámetros

hCall

Controle a la llamada cuyos parámetros se van a cambiar. La aplicación debe ser propietario de la llamada. El estado de llamada de hCall puede ser cualquier estado excepto inactivo o desconectado.

dwBearerMode

Nuevo modo de portador para la llamada. Este parámetro usa una y solo una de las constantes de LINEBEARERMODE_.

dwMinRate

Límite inferior para la nueva velocidad de datos de la llamada. La aplicación puede aceptar una nueva tarifa tan baja como esta.

dwMaxRate

Límite superior para la nueva velocidad de datos de la llamada. Esta es la velocidad máxima de datos que la aplicación puede aceptar. Si se requiere una velocidad de datos exacta, dwMinRate y dwMaxRate deben ser iguales.

lpDialParams

Puntero a los nuevos parámetros de marcado para la llamada, de tipo LINEDIALPARAMS. Este parámetro se puede dejar NULL si se van a usar los parámetros de marcado actuales de la llamada.

Valor devuelto

Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de LINE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_BEARERMODEUNAVAIL, LINEERR_NOTOWNER, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RATEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALRATE, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

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.