функция TSPI_lineNegotiateTSPIVersion (tspi.h)

Статья
03/13/2024

Функция TSPI_lineNegotiateTSPIVersion возвращает самую высокую версию SPI, в которой поставщик услуг может работать для этого устройства, учитывая диапазон возможных версий SPI.

Синтаксис

LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
  DWORD   dwDeviceID,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwTSPIVersion
);

Параметры

dwDeviceID

Идентифицирует устройство линии, для которого требуется выполнить согласование версии интерфейса. Помимо идентификаторов устройств в диапазоне, который поддерживает поставщик услуг, это может быть значение:

INITIALIZE_NEGOTIATION

Это значение используется для обозначения согласования общей версии интерфейса.

dwLowVersion

Самый низкий номер версии TSPI, под которым может работать TAPI. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии.

dwHighVersion

Самый высокий номер версии TSPI, под которым может работать TAPI. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии.

lpdwTSPIVersion

Указатель на DWORD. Поставщик услуг заполняет это расположение самым высоким номером версии TSPI в диапазоне, запрашиваемом вызывающим абонентом, в котором может работать поставщик услуг. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии. Если запрошенный диапазон не перекрывает диапазон, поддерживаемый поставщиком услуг, функция возвращает LINEERR_INCOMPATIBLEAPIVERSION.

Возвращаемое значение

Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Если параметр dwDeviceIDINITIALIZE_NEGOTIATION, эта функция не должна возвращать LINEERR_OPERATIONUNAVAIL, так как эта функция (с этим значением) является обязательной для согласования общей версии интерфейса, даже если поставщик услуг не поддерживает линейные устройства.