Estructura LINECALLPARAMS (tapi.h)
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_.
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.
Requisitos
| Encabezado | tapi.h |