Iniciar una sesión
Los principales datos que proporciona una aplicación para iniciar una sesión de comunicaciones son el tipo de dirección, el tipos de medio o tipos, y la dirección de destino.
La dirección de destino puede requerir dirección de traducción para poner la información introducida por un usuario en el formato adecuado para un tipo de dirección determinado. Por ejemplo, un número telefónico que estaba en una agenda electrónica en canónico requerirá la traducción a que se marca formato.
Algunas sesiones pueden requerir parámetros de configuración especiales, si el proveedor de servicios los admite. Por ejemplo, un TSP RDSI puede transmitir información usuario-usuario, y algunos MSP requieren información sobre la dirección del flujo de medios. Consulte Información de sesión para la revisión de los datos que puedan establecerse u obtenerse en relación con una sesión.
Una vez iniciada la sesión, TAPI informará a la aplicación del progreso de la llamada utilizando el mecanismo de notificación de eventos configurado durante la inicialización.
TAPI 2.x: Las aplicaciones inician una sesión utilizando el lineMakeCall función. El lineTranslateAddress función se utiliza para realizar la traducción de direcciones, si es necesario.
Los parámetros de configuración de llamada pueden almacenarse en el LINECALLPARAMS y, a continuación, se utiliza un puntero a esta estructura como parámetro de lineMakeCall. Si no LINECALLPARAMS se suministra a lineMakeCall, se solicita una llamada de voz POTS por defecto con una serie de valores predeterminados.
Si la sesión se establece correctamente, se generará un manejador de llamada con propietario privilegios se devuelve y la TAPI envía la aplicación LINE_CALLSTATE mensajes con información sobre el progreso de la llamada. Las aplicaciones suelen utilizar estos mensajes para mostrar informes de estado al usuario.
TAPI 3.x: Las aplicaciones inician una sesión de comunicaciones invocando la función ITAddress::CreateCall método en una dirección capaz de manejar el tipo de dirección y el tipo de medio requeridos. Si la dirección expone el ITTerminalSupport interfaz, los terminales se seleccionan en los flujos de medios del objeto de llamada. Consulte el Hacer una llamada ejemplo de código para una ilustración de este proceso.
Los parámetros de configuración de la llamada pueden almacenarse o modificarse mediante los métodos expuestos por la función ITCallInfo interfaz.
Si la sesión se establece con éxito, TAPI vuelve a ITBasicCallControl interfaz que puede utilizarse para otras operaciones de la sesión, o para obtener un ITCallInfo interfaz que puede utilizarse para obtener información adicional sobre la sesión. El ITCallStateEvent interfaz procesa eventos de estado de llamada TAPI.
Nota:
TAPI no debe utilizarse para transmisiones de fax. En su lugar, utilice las funciones disponibles a través de MAPI, la API de mensajería de Microsoft.
Traducción dirección
Un usuario final o una aplicación de servidor pueden almacenar direcciones en un formato que no sea compatible con las necesidades de un determinado proveedor de servicios. Por ejemplo, un número telefónico puede almacenarse en una agenda electrónica en formato canónico, pero la mayoría de los proveedores de servicios que manejan números telefónicos requieren el formato marcado.
TAPI proporciona operaciones de traducción de direcciones que ayudan a una aplicación a presentar el tipo de dirección correcto a un TSP. El proveedor de servicios especifica a TAPI qué tipos de direcciones admite, y no necesita incluir ninguna forma de traducción de direcciones.
TAPI 2.x: Consulte lineTranslateAddress.
TAPI 3: Consulte ITAddressTranslation, ITAddressTranslationInfo.
Listas de peajes
En algunos lugares de Norteamérica, todas las llamadas telefónicas realizadas al prefijo local son llamadas locales. En otros lugares, algunas llamadas realizadas al prefijo local son de larga distancia y necesitan un prefijo "1" para ser marcadas. Los tres primeros dígitos de la dirección (el prefijo) determinan si una llamada dentro del prefijo local es o no de pago.
Una lista de peaje es una lista de prefijos del prefijo local cuyas direcciones deben marcarse como direcciones de larga distancia, y se les aplican tarifas de larga distancia.
Las listas de peajes no son relevantes para los proveedores de servicios ni para las aplicaciones que no acceden a una red telefónica.
TAPI 2.x: Consulte lineTranslateAddress (LINETRANSLATERESULT_INTOLLLIST and LINETRANSLATERESULT_NOTINTOLLLIST bits en el LINETRANSLATEOUTPUT estructura), lineSetTollList.
TAPI 3: Consulte ITAddressTranslation::TranslateAddress, ITAddressTranslationInfo::get_TranslationResults.