función TSPI_lineNegotiateExtVersion (tspi.h)
La función TSPI_lineNegotiateExtVersion 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_lineNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Parámetros
dwDeviceID
Identifica el dispositivo de línea para el que se va a realizar la negociación de la versión de interfaz. Es posible que el valor INITIALIZE_NEGOTIATION no se use para esta función.
dwTSPIVersion
Número de versión de interfaz que ya se ha negociado para este dispositivo mediante TSPI_lineNegotiateTSPIVersion. 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. TAPI no valida este parámetro cuando se llama a esta función.
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. TAPI no valida este parámetro cuando se llama a esta función.
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 LINEERR_INCOMPATIBLEEXTVERSION.
Valor devuelto
Devuelve cero si la función se ejecuta correctamente o un número de error si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Comentarios
TapI puede llamar a esta función antes o después de abrir el dispositivo. Si el dispositivo está abierto actualmente y tiene seleccionada una versión de extensión, la función proporciona 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 LINEERR_INCOMPATIBLEEXTVERSION.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |