función TSPI_phoneNegotiateExtVersion (tspi.h)

La función TSPI_phoneNegotiateExtVersion devuelve el número de versión de extensión más alto en el que puede funcionar el proveedor de servicios para este dispositivo, dada la gama de posibles versiones de extensión.

Sintaxis

LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

Parámetros

dwDeviceID

Identifica el dispositivo telefónico para el que se va a realizar la negociación de la versión de interfaz.

dwTSPIVersion

Especifica un número de versión de interfaz que se negocia para este dispositivo mediante TSPI_phoneNegotiateTSPIVersion. Esta función funciona según la especificación de interfaz en este nivel de versión.

dwLowVersion

Número de versión de extensión más bajo el que puede funcionar TAPI o su aplicación cliente. 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.

dwHighVersion

Número de versión de extensión más alto bajo el que puede funcionar TAPI o su aplicación cliente. 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.

lpdwExtVersion

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 extensión 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_INCOMPATIBLEEXTVERSION.

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_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.

Comentarios

Se puede llamar a esta función antes o después de que TAPI haya abierto el dispositivo. Si el dispositivo está abierto actualmente y tiene seleccionada una versión de extensión, la función debe devolver ese número de versión si está dentro del intervalo solicitado. Si el número de versión seleccionado está fuera del intervalo solicitado, la función devuelve PHONEERR_INCOMPATIBLEEXTVERSION.

Requisitos

Plataforma de destino	Windows
Encabezado	tspi.h

Consulte también

TSPI_phoneNegotiateTSPIVersion