TSPI_lineNegotiateTSPIVersion función (tspi.h)
La función TSPI_lineNegotiateTSPIVersion devuelve la versión de 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_lineNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
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. Además de los identificadores de dispositivo dentro del intervalo que admite el proveedor de servicios, este puede ser el valor:
INITIALIZE_NEGOTIATION
Este valor se usa para indicar que se negocia una versión general de la interfaz.
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 word 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 word menos significativo es el número de versión secundaria.
lpdwTSPIVersion
Puntero a un DWORD. 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 LINEERR_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:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentarios
Cuando dwDeviceID es INITIALIZE_NEGOTIATION, esta función no debe devolver LINEERR_OPERATIONUNAVAIL, ya que esta función (con ese valor) es obligatoria para negociar la versión general de la interfaz aunque el proveedor de servicios no admita dispositivos de línea.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tspi.h |