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 |