TSPI_phoneNegotiateTSPIVersion función (tspi.h)

La función TSPI_phoneNegotiateTSPIVersion devuelve la versión spi más alta en la que el proveedor de servicios puede funcionar para este dispositivo, dada la gama de posibles versiones spi.

Sintaxis

LONG TSPIAPI TSPI_phoneNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Parámetros

dwDeviceID

Dispositivo telefónico para el que se va a realizar la negociación de la versión de interfaz. Los valores permitidos están estrictamente dentro del intervalo de identificadores de dispositivos telefónicos para este proveedor de servicios; el valor INITIALIZE_NEGOTIATION nunca se pasa a esta función.

dwLowVersion

Número de versión de TSPI más bajo el que puede funcionar TAPI. El word más significativo es el número de versión principal y el menos significativo es el número de versión secundaria.

dwHighVersion

Número de versión de TSPI más alto bajo el que puede funcionar TAPI. El word más significativo es el número de versión principal y el menos significativo es el número de versión secundaria.

lpdwTSPIVersion

Puntero a un DWORD. Tras una devolución correcta de esta función, el proveedor de servicios rellena esta ubicación con el número de versión de TSPI más alto, dentro del intervalo solicitado por el autor de la llamada, con el que el proveedor de servicios puede funcionar. El word más significativo es el número de versión principal y word menos significativo es el número de versión secundaria. Si el intervalo solicitado no se superpone al intervalo admitido por el proveedor de servicios, la función devuelve PHONEERR_INCOMPATIBLEAPIVERSION.

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:

PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Comentarios

El proveedor de servicios devuelve PHONEERR_OPERATIONUNAVAIL si la operación no está disponible. Sin embargo, si el proveedor de servicios admite dispositivos telefónicos, también debe admitir esta función y la función no debe devolver PHONEERR_OPERATIONUNAVAIL.

TAPI llama a esta función al principio de la secuencia de inicialización para cada dispositivo telefónico.

La negociación de una versión de extensión se realiza a través del procedimiento independiente TSPI_phoneNegotiateExtVersion.

La función correspondiente en el nivel tapi es una función sobrecargada que también recupera el identificador de extensión, si existe, compatible con el proveedor de servicios. En el nivel de TSPI, la recuperación del identificador de extensión se realiza a través de un procedimiento independiente, es decir, TSPI_phoneGetExtensionID.

Requisitos

Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion