Inicialización y apagado

Para que una aplicación use cualquiera de las 30 funciones telefónicas complementarias de TAPI, necesita una conexión a TAPI, a través de la cual puede recibir mensajes. La aplicación establece esta conexión mediante la funciónphoneInitializeEx. En esta función, la aplicación especifica el mecanismo de notificación por el que TAPI informa a la aplicación de cambios en el estado del teléfono y de la finalización asincrónica de funciones telefónicas.

La funciónphoneInitializeExdevuelve dos fragmentos de información a la aplicación: una aplicación controlay el número de dispositivos telefónicos. El identificador de aplicación representa el uso de la aplicación de TAPI. Las funciones TAPI que usan identificadores de teléfono no requieren el identificador de aplicación, ya que este identificador se deriva del identificador de teléfono especificado.

El segundo fragmento de información devuelto por phoneInitializeEx es el número de dispositivos telefónicos disponibles para TAPI. Los dispositivos telefónicos se identifican mediante su identificador de dispositivo (identificador de dispositivo). Los identificadores de dispositivo válidos oscilan entre cero y el número de dispositivos telefónicos menos uno. Por ejemplo, si phoneInitializeEx informa de que hay dos dispositivos telefónicos en un sistema, los identificadores de dispositivo telefónico válidos son 0 y 1. Una vez finalizada la aplicación mediante las funciones de teléfono de TAPI, invoca phoneShutdown, pasando su identificador de aplicación para apagar su uso de TAPI. Esto permite que TAPI libere los recursos asignados a la aplicación.

Las aplicaciones no deben invocar phoneInitializeEx sin abrir posteriormente un teléfono (al menos para la supervisión). Si la aplicación no está supervisando y no usa ningún dispositivo, debe llamar a phoneShutdown para que los recursos de memoria asignados por la biblioteca de vínculos dinámicos TAPI se puedan liberar si no se necesitan y la propia biblioteca se puede descargar de la memoria mientras no es necesario.

Tanto phoneInitializeEx como phoneShutdown funcionan sincrónicamente. Es decir, estas funciones devuelven una indicación correcta o errónea y nunca devuelven un identificador de solicitud asincrónico.