función TSPI_phoneOpen (tspi.h)
La función TSPI_phoneOpen abre el dispositivo telefónico cuyo identificador de dispositivo se especifica, devolviendo el identificador opaco del proveedor de servicios para el dispositivo y conservando el identificador opaco de TAPI para el dispositivo para usarlo en llamadas posteriores al procedimiento PHONEEVENT .
Sintaxis
LONG TSPIAPI TSPI_phoneOpen(
DWORD dwDeviceID,
HTAPIPHONE htPhone,
LPHDRVPHONE lphdPhone,
DWORD dwTSPIVersion,
PHONEEVENT lpfnEventProc
);
Parámetros
dwDeviceID
Dispositivo telefónico que se va a abrir.
htPhone
Identificador opaco tapi para que el dispositivo telefónico se use en llamadas posteriores al procedimiento de devolución de llamada PHONEEVENT para identificar el dispositivo.
lphdPhone
Puntero a un HDRVPHONE donde el proveedor de servicios escribe su identificador para que el dispositivo telefónico lo use TAPI en llamadas posteriores para identificar el dispositivo.
dwTSPIVersion
La versión de TSPI negociada a través de TSPI_phoneNegotiateTSPIVersion bajo la cual el proveedor de servicios puede operar.
lpfnEventProc
Puntero al procedimiento de devolución de llamada PHONEEVENT proporcionado por TAPI que el proveedor de servicios llama para notificar eventos posteriores en el teléfono.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
PHONEERR_ALLOCATED, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_INUSE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INIFILECORRUPT.
Comentarios
Abrir un teléfono da derecho a TAPI para realizar más solicitudes en el teléfono. El teléfono se activa en el sentido de que el proveedor de servicios puede notificar eventos asincrónicos, como cambios de hookswitch o pulsaciones de botón. El proveedor de servicios reserva los recursos no compartidos necesarios para administrar el teléfono. Por ejemplo, abrir un teléfono al que se accede a través de un puerto y módem comm debe dar lugar a la apertura del puerto de coma, lo que hace que ya no esté disponible para su uso por otras aplicaciones.
Si la función se ejecuta correctamente, TAPI y el proveedor de servicios se confirman para funcionar con el número de versión de interfaz especificado para este dispositivo abierto. Las operaciones y eventos posteriores identificados mediante los identificadores de teléfono opaco intercambiados se ajustan a esa versión de interfaz. Este compromiso y la validez de los identificadores permanecen en vigor hasta que TAPI cierra el teléfono mediante TSPI_phoneClose o hasta que el proveedor de servicios notifica el evento PHONE_CLOSE . Si la función no se realiza correctamente, no se realiza este compromiso y los identificadores no son válidos.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |