TSPI_lineOpen función (tspi.h)

Artículo
08/26/2023

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.