Estructura LINECALLPARAMS (tapi.h)

Artículo
08/26/2023

La estructura LINECALLPARAMS describe los parámetros proporcionados al realizar llamadas mediante las funciones lineMakeCall y TSPI_lineMakeCall . La estructura LINECALLPARAMS también se usa como parámetro en otras operaciones, como la función lineOpen .

Los comentarios a la derecha del bloque de sintaxis indican los valores predeterminados usados cuando esta estructura no se proporciona a lineMakeCall.

Sintaxis

typedef struct linecallparams_tag {
  DWORD          dwTotalSize;
  DWORD          dwBearerMode;
  DWORD          dwMinRate;
  DWORD          dwMaxRate;
  DWORD          dwMediaMode;
  DWORD          dwCallParamFlags;
  DWORD          dwAddressMode;
  DWORD          dwAddressID;
  LINEDIALPARAMS DialParams;
  DWORD          dwOrigAddressSize;
  DWORD          dwOrigAddressOffset;
  DWORD          dwDisplayableAddressSize;
  DWORD          dwDisplayableAddressOffset;
  DWORD          dwCalledPartySize;
  DWORD          dwCalledPartyOffset;
  DWORD          dwCommentSize;
  DWORD          dwCommentOffset;
  DWORD          dwUserUserInfoSize;
  DWORD          dwUserUserInfoOffset;
  DWORD          dwHighLevelCompSize;
  DWORD          dwHighLevelCompOffset;
  DWORD          dwLowLevelCompSize;
  DWORD          dwLowLevelCompOffset;
  DWORD          dwDevSpecificSize;
  DWORD          dwDevSpecificOffset;
  DWORD          dwPredictiveAutoTransferStates;
  DWORD          dwTargetAddressSize;
  DWORD          dwTargetAddressOffset;
  DWORD          dwSendingFlowspecSize;
  DWORD          dwSendingFlowspecOffset;
  DWORD          dwReceivingFlowspecSize;
  DWORD          dwReceivingFlowspecOffset;
  DWORD          dwDeviceClassSize;
  DWORD          dwDeviceClassOffset;
  DWORD          dwDeviceConfigSize;
  DWORD          dwDeviceConfigOffset;
  DWORD          dwCallDataSize;
  DWORD          dwCallDataOffset;
  DWORD          dwNoAnswerTimeout;
  DWORD          dwCallingPartyIDSize;
  DWORD          dwCallingPartyIDOffset;
  DWORD          dwAddressType;
} LINECALLPARAMS, *LPLINECALLPARAMS;

Miembros

dwTotalSize

Tamaño total asignado a esta estructura de datos, en bytes. Este tamaño debe ser lo suficientemente grande como para contener todas las partes fijas y de tamaño variable de esta estructura de datos.

dwBearerMode

Modo de portador para la llamada. Este miembro usa una de las constantes LINEBEARERMODE_.

Si dwBearerMode es cero, el valor predeterminado es LINEBEARERMODE_VOICE.

dwMinRate

Velocidad de datos mínima solicitada para el flujo de datos de la llamada, en bps (bits por segundo).

dwMaxRate

Velocidad máxima de datos solicitada para el flujo de datos de la llamada, en bps (bits por segundo). Al realizar una llamada, el proveedor de servicios intenta proporcionar la tasa más alta disponible en el intervalo solicitado (dwMinRate a dwMaxRate). Si se requiere una velocidad de datos específica, dwMinRate y dwMaxRate deben establecerse en ese valor. Si una aplicación funciona mejor con una tasa, pero puede degradarse a tasas más bajas, la aplicación debe especificarlas como las tarifas máximas y mínimas, respectivamente. Si dwMaxRate es cero, el valor predeterminado es el especificado por el miembro dwMaxRate de la estructura LINEDEVCAPS . Esta es la velocidad máxima admitida por el dispositivo.

dwMediaMode

Tipo de medio esperado de la llamada. Este miembro usa una de las constantes LINEMEDIAMODE_.

Si dwMediaMode es cero, el valor predeterminado es LINEMEDIAMODE_INTERACTIVEVOICE.

dwCallParamFlags

Colección de parámetros booleanos de configuración de llamadas. Este miembro usa una o varias de las constantes LINECALLPARAMFLAGS_.

dwAddressMode

Modo por el que se especifica la dirección de origen. Este miembro usa una de las constantes LINEADDRESSMODE_.

Nota El miembro dwAddressMode no puede ser LINEADDRESSMODE_ADDRESSID para la llamada de función lineOpen . Sin embargo, esta restricción no se aplica a lineMakeCall.

dwAddressID

Identificador de dirección de la dirección de origen si dwAddressMode está establecido en LINEADDRESSMODE_ADDRESSID. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

DialParams

Parámetros de marcado que se usarán en esta llamada, de tipo LINEDIALPARAMS. Cuando se especifica un valor de 0 para este campo, el valor predeterminado para el campo se usa como se indica en el miembro DefaultDialParams de la estructura LINEDEVCAPS . Si se especifica un valor distinto de cero para un campo que está fuera del intervalo especificado por los campos correspondientes de MinDialParams y MaxDialParams en la estructura LINEDEVCAPS , se usa en su lugar el valor más cercano dentro del intervalo válido.

dwOrigAddressSize

Tamaño del campo de dirección de origen, en bytes.

dwOrigAddressOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene la dirección de origen. El formato de esta dirección depende del miembro dwAddressMode . El tamaño del campo se especifica mediante dwOrigAddressSize.

dwDisplayableAddressSize

Tamaño de la cadena que se puede mostrar, incluido el terminador null , en bytes.

dwDisplayableAddressOffset

Cadena que se puede mostrar utilizada para fines de registro. El contenido de estos miembros se registra en los miembros dwDisplayableAddressOffset y dwDisplayableAddressSize miembros del mensaje LINECALLINFO de la llamada. La función lineTranslateAddress devuelve la información adecuada que se va a colocar en este campo en los miembros dwDisplayableAddressSize y dwDisplayableAddressOffset de la estructura LINETRANSLATEOUTPUT . DwDisplayableAddressSize especifica el tamaño del campo.

dwCalledPartySize

Tamaño de la información de la entidad llamada, en bytes.

dwCalledPartyOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene información de entidad llamada. Esta información se puede especificar mediante la aplicación que realiza la llamada y está disponible en la estructura de información de la llamada para fines de registro. El formato de este campo es el de dwStringFormat, como se especifica en LINEDEVCAPS. DwCalledPartySize especifica el tamaño del campo.

dwCommentSize

Tamaño del campo de comentario de llamada, en bytes.

dwCommentOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene comentarios sobre la llamada. Esta información se puede especificar mediante la aplicación que realiza la llamada y está disponible en la estructura de información de la llamada para fines de registro. El formato de este campo es el de dwStringFormat, como se especifica en LINEDEVCAPS. DwCommentSize especifica el tamaño del campo.

dwUserUserInfoSize

Tamaño de la información de usuario-usuario, incluido el terminador nulo , en bytes.

dwUserUserInfoOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene información del usuario-usuario. El campo discriminador de protocolo para la información del usuario, si es necesario, debe aparecer como el primer byte de los datos a los que apunta dwUserInfoOffset y debe tener en cuenta en dwUserUserInfoSize.

dwHighLevelCompSize

Tamaño de la información de compatibilidad de alto nivel, en bytes.

dwHighLevelCompOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información de compatibilidad de alto nivel. El tamaño del campo se especifica mediante dwHighLevelCompSize.

dwLowLevelCompSize

Tamaño de la información de compatibilidad de bajo nivel, en bytes.

dwLowLevelCompOffset

Desplazamiento desde el principio de la estructura hasta el campo de tamaño variable que contiene información de compatibilidad de bajo nivel. El tamaño del campo se especifica mediante dwLowLevelCompSize.

dwDevSpecificSize

Tamaño de la información específica del dispositivo, en bytes.

dwDevSpecificOffset

Desfase desde el principio de la estructura hasta el campo de tamaño variable que contiene información específica del dispositivo. El tamaño del campo se especifica mediante dwDevSpecificSize.

dwPredictiveAutoTransferStates

LINECALLSTATE_ constantes, entrada en la que la llamada se transfiere ciegamente a la dirección de destino especificada. Se establece en cero si no se desea la transferencia automática.

dwTargetAddressSize

Tamaño de la cadena de dirección de marcado de destino, incluido el terminador null , en bytes.

dwTargetAddressOffset

Desplazamiento desde el principio de la estructura a una cadena que especifica la dirección de marcado de destino (no dwAddressID); se usa en el caso de determinadas acciones automáticas. En el caso de la marcación predictiva, especifica la dirección a la que se debe transferir automáticamente la llamada. El tamaño de la cadena se especifica mediante dwTargetAddressSize.

Esta es básicamente la misma cadena que se pasaría a lineBlindTransfer si no se usaba la transferencia automática. Se establece en cero si no se desea la transferencia automática. En el caso de una conferencia sin suspensión, especifica la dirección que se debe conferenciar a la llamada. En el caso de una transferencia de un solo paso, especifica la dirección que se va a marcar en la llamada de consulta.

dwSendingFlowspecSize

Tamaño de la calidad de la información del servicio, en bytes.

dwSendingFlowspecOffset

Desplazamiento desde el principio de la estructura a una estructura FLOWSPEC seguida de datos específicos del proveedor de WinSock, equivalentes a lo que se habría almacenado en SendingFlowspec en una estructura de QOS . Especifica la calidad del servicio deseado en la dirección de envío en la llamada. La parte específica del proveedor que sigue a la estructura FLOWSPEC no debe contener punteros a otros bloques de memoria, ya que TAPI no sabe cómo serializar los datos a los que apuntan los punteros privados y transmitirlos a través de la comunicación entre procesos a la aplicación. El tamaño del campo se especifica mediante dwSendingFlowspecSize.

dwReceivingFlowspecSize

Tamaño de la calidad de la información del servicio, en bytes.

dwReceivingFlowspecOffset

Desplazamiento desde el principio de la estructura a una estructura FLOWSPEC seguida de datos específicos del proveedor de WinSock, equivalentes a lo que se habría almacenado en ReceiveingFlowspec en una estructura de QOS . Especifica la calidad de servicio deseada en la dirección de recepción de la llamada. La parte específica del proveedor que sigue a la estructura FLOWSPEC no debe contener punteros a otros bloques de memoria, ya que TAPI no sabe cómo serializar los datos a los que apuntan los punteros privados y transmitirlos a través de la comunicación entre procesos a la aplicación. El tamaño del campo se especifica mediante dwReeplyFlowspecSize.

dwDeviceClassSize

Tamaño de la cadena de clase de dispositivo, incluido el terminador null , en bytes.

dwDeviceClassOffset

Desplazamiento desde el principio de la estructura a una cadena terminada en null que indica la clase de dispositivo del dispositivo cuya configuración se especifica en DeviceConfig. Las cadenas de clase de dispositivo válidas son las mismas que las especificadas para la función lineGetID . DwDeviceClassSize especifica el tamaño de la cadena.

dwDeviceConfigSize

Tamaño de los datos de configuración del dispositivo, en bytes.

dwDeviceConfigOffset

Desfase desde el principio de la estructura hasta la estructura de datos de configuración opaca. Este valor se devuelve en el miembro dwStringSize de la estructura VARSTRING devuelta por lineGetDevConfig. Si el tamaño es cero, se usa la configuración predeterminada del dispositivo. Esto permite a la aplicación establecer la configuración del dispositivo antes de iniciar la llamada. DwDeviceConfigSize especifica el tamaño del campo.

dwCallDataSize

Tamaño de los datos de llamada que se pueden establecer en la aplicación, en bytes.

dwCallDataOffset

Desplazamiento desde el principio de la estructura hasta los datos de llamada que se pueden establecer para la aplicación que se van a adjuntar inicialmente a la llamada. DwCallDataSize especifica el tamaño del campo.

dwNoAnswerTimeout

Número de segundos, después de la finalización de la marcación, se debe permitir que la llamada espere en los estados PROCEDIMIENTO o RINGBACK, antes de que el proveedor de servicios lo abandone automáticamente con un LINECALLSTATE_DISCONNECTED y LINEDISCONNECTMODE_NOANSWER. Un valor de 0 indica que la aplicación no desea el abandono automático de llamadas.

dwCallingPartyIDSize

Tamaño de la cadena de identificador de entidad que llama, incluido el terminador null , en bytes, incluido el carácter de terminación null.

dwCallingPartyIDOffset

Desfase desde el principio de la estructura a una cadena terminada en null que especifica la identidad de la entidad que realiza la llamada. Si el contenido del identificador es aceptable y hay disponible una ruta de acceso, el proveedor de servicios pasa el identificador a la parte llamada para indicar la identidad de la entidad que realiza la llamada. El tamaño del campo se especifica mediante dwCallingPartyIDSize.

dwAddressType

Tipo de dirección usado para la llamada. Este miembro de la estructura solo está disponible si la versión de TAPI negociada es 3.0 o posterior.

Comentarios

Las extensiones específicas del dispositivo deben usar el área de tamaño variable DevSpecific (dwDevSpecificSize y dwDevSpecificOffset) de esta estructura de datos.

Esta estructura se usa como parámetro para lineMakeCall al configurar una llamada. Sus campos permiten a la aplicación especificar la calidad del servicio solicitado desde la red, así como una variedad de parámetros de configuración de llamadas ISDN. Si no se proporciona ninguna estructura LINECALLPARAMS a lineMakeCall, se solicita una llamada de nivel de voz POTS predeterminada con los valores predeterminados enumerados anteriormente.

Nota Los campos DialParams a través de dwDevSpecificOffset se omiten cuando se especifica un parámetro lpCallParams con la función lineOpen .

Los miembros dwPredictiveAutoTransferStates a través de dwCallingPartyIDOffset solo están disponibles para las aplicaciones que abren el dispositivo de línea con una versión de API de 2.0 o posterior.