TSPI_lineOpen función (tspi.h)
La función TSPI_lineOpen abre el dispositivo de línea cuyo identificador de dispositivo se indica y devuelve el identificador del proveedor de servicios para el dispositivo. El proveedor de servicios debe conservar el identificador TAPI del dispositivo para su uso en llamadas posteriores al procedimiento de devolución de llamada LINEEVENT .
Sintaxis
LONG TSPIAPI TSPI_lineOpen(
DWORD dwDeviceID,
HTAPILINE htLine,
LPHDRVLINE lphdLine,
DWORD dwTSPIVersion,
LINEEVENT lpfnEventProc
);
Parámetros
dwDeviceID
Identifica el dispositivo de línea que se va a abrir.
htLine
Identificador TAPI para que el dispositivo de línea se use en llamadas posteriores al procedimiento de devolución de llamada LINEEVENT para identificar el dispositivo.
lphdLine
Puntero a HDRVLINE donde el proveedor de servicios rellena su identificador para el dispositivo de línea.
dwTSPIVersion
La versión de TSPI.
lpfnEventProc
Puntero al procedimiento de devolución de llamada LINEEVENT proporcionado por TAPI que el proveedor de servicios llama para notificar eventos posteriores en la línea.
Valor devuelto
Devuelve cero si la función se realiza correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentarios
El proveedor de servicios debe reservar los recursos no compartibles necesarios para administrar la línea. Sin embargo, cualquier acción que se pueda posponer a lineMakeCall debe ser. Es una suposición de diseño en TAPI que lineOpen es una operación "económica". Por ejemplo, si la línea solo se abre en modo de supervisión, no debe ser necesario que un proveedor de servicios basado en puertos COMM abra el puerto COMM.
Este procedimiento no se corresponde directamente con ningún procedimiento en el nivel TAPI, en el que las funciones de habilitar extensiones específicas del dispositivo, seleccionar características de línea y establecer la detección de tipos de medios se incluyen en la funcionalidad definida por lineOpen. En el nivel de TSPI, estas funcionalidades adicionales se separan en TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection y TSPI_lineConditionalMediaDetection.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | tspi.h |