Поделиться через

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

  • Статья

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

Синтаксис

LONG TSPIAPI TSPI_lineNegotiateExtVersion(
  DWORD   dwDeviceID,
  DWORD   dwTSPIVersion,
  DWORD   dwLowVersion,
  DWORD   dwHighVersion,
  LPDWORD lpdwExtVersion
);

Параметры

dwDeviceID

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

dwTSPIVersion

Номер версии интерфейса, который уже согласован для этого устройства с помощью TSPI_lineNegotiateTSPIVersion. Эта функция работает в соответствии со спецификацией интерфейса на этом уровне версии.

dwLowVersion

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

dwHighVersion

Максимальный номер версии расширения, под которым может работать TAPI или его клиентское приложение. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии. TAPI не проверяет этот параметр при вызове этой функции.

lpdwExtVersion

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

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

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

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

Комментарии

Эту функцию можно вызывать до или после открытия устройства с помощью TAPI. Если устройство открыто и имеет выбранную версию расширения, функция присваивает номер версии, если она находится в пределах запрошенного диапазона. Если выбранный номер версии выходит за пределы запрошенного диапазона, функция возвращает LINEERR_INCOMPATIBLEEXTVERSION.

Требования

   
Целевая платформа Windows
Header tspi.h

См. также раздел

INITIALIZE_NEGOTIATION

TSPI_lineNegotiateTSPIVersion