функция 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 |