TSPI_lineNegotiateTSPIVersion función (tspi.h)

Artículo
08/26/2023

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.