Funciones complementarias del servicio telefónico

Las funciones complementarias del servicio telefónico se enumeran por categoría en los temas siguientes. Una función se identifica como asincrónica si indicará la finalización en un mensaje REPLY a la aplicación. Si la función siempre devuelve su resultado a la aplicación inmediatamente, la función se considera sincrónica.

A continuación se muestra una agrupación funcional de las funciones complementarias del servicio telefónico:

• Botones
• Áreas de datos
• Pantalla
• Dispositivos Hookswitch
• 5.5 Lámparas
• Apertura y cierre de dispositivos telefónicos
• Inicialización y apagado del teléfono
• Estado y funcionalidades del teléfono
• Negociación de la versión del teléfono
• En anillo
• Estado

Inicialización y apagado del teléfono

Función	Descripción
phoneInitializeEx	Inicializa la abstracción de teléfono TAPI para que la aplicación de invocación la use. Synchronous.
phoneShutdown	Apaga el uso de una aplicación de la abstracción telefónica de TAPI. Synchronous.

 

Negociación de versión de teléfono

Función	Descripción
phoneNegotiateAPIVersion	Permite que una aplicación negocie una versión TAPI para usarla. Synchronous.

 

Abrir y cerrar dispositivos telefónicos

Función	Descripción
phoneOpen	Abre el dispositivo telefónico especificado, lo que proporciona a la aplicación privilegios de propietario o supervisión. Synchronous.
phoneClose	Cierra un dispositivo telefónico abierto especificado. Synchronous.

 

Estado y funcionalidades del teléfono

Función	Descripción
phoneGetDevCaps	Devuelve las funcionalidades de un dispositivo telefónico determinado. Synchronous.
phoneGetID	Devuelve un identificador de dispositivo para la clase de dispositivo especificada asociada al dispositivo telefónico especificado. Synchronous.
phoneGetIcon	Permite que una aplicación recupere un icono para mostrar al usuario. Synchronous.
phoneConfigDialog	Hace que el proveedor del dispositivo telefónico especificado muestre un cuadro de diálogo que permita al usuario configurar parámetros relacionados con el dispositivo telefónico. Synchronous.

 

Dispositivos hookswitch

Función	Descripción
phoneSetHookSwitch	Establece el estado de enlace de los dispositivos hookswitch de un teléfono abierto en un modo especificado. Asincrónica
phoneGetHookSwitch	Consulta el modo hookswitch de un dispositivo hookswitch de un dispositivo telefónico abierto. Synchronous.
phoneSetVolume	Establece el volumen de un altavoz del dispositivo hookswitch de un dispositivo de teléfono abierto. Asincrónica
phoneGetVolume	Devuelve la configuración de volumen del altavoz de un dispositivo hookswitch de un dispositivo de teléfono abierto. Synchronous.
phoneSetGain	Establece la ganancia de un micrófono del dispositivo hookswitch de un dispositivo de teléfono abierto. Asincrónica
phoneGetGain	Devuelve la configuración de ganancia del micrófono de un dispositivo hookswitch de un teléfono abierto. Synchronous.

 

Mostrar

Función	Descripción
phoneSetDisplay	Escribe información en la pantalla de un dispositivo telefónico abierto. Asincrónica
phoneGetDisplay	Devuelve el contenido actual de la pantalla de un teléfono. Synchronous.

 

En anillo

Función	Descripción
phoneSetRing	Llama a un dispositivo de teléfono abierto según un modo de anillo determinado. Asincrónica
phoneGetRing	Devuelve el modo de anillo actual de un dispositivo telefónico abierto. Synchronous.

 

Botones

Función	Descripción
phoneSetButtonInfo	Establece la información asociada a un botón en un dispositivo telefónico. Asincrónica
phoneGetButtonInfo	Devuelve información asociada a un botón en un dispositivo telefónico. Synchronous.

 

5.5 Lámparas

Función	Descripción
phoneSetLamp	Ilumina una lámpara en un dispositivo telefónico abierto especificado en un modo de iluminación de lámpara determinado. Asincrónica
phoneGetLamp	Devuelve el modo de lámpara actual de la lámpara especificada. Synchronous.

 

Áreas de datos

Función	Descripción
phoneSetData	Descarga un búfer de datos en un área de datos determinada en el dispositivo telefónico. Asincrónica
phoneGetData	Carga el contenido de un área de datos determinada en el dispositivo telefónico en un búfer. Synchronous.

 

Estado

Función	Descripción
phoneSetStatusMessages	Especifica los cambios de estado para los que la aplicación quiere recibir una notificación. Synchronous.
phoneGetStatusMessages	Devuelve los cambios de estado para los que la aplicación quiere recibir una notificación. Synchronous.
phoneGetStatus	Devuelve el estado completo de un dispositivo telefónico abierto. Synchronous.