функция TSPI_phoneNegotiateExtVersion (tspi.h)
Функция TSPI_phoneNegotiateExtVersion возвращает максимальный номер версии расширения, с которым поставщик услуг может работать для этого устройства, учитывая диапазон возможных версий расширения.
Синтаксис
LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Параметры
dwDeviceID
Определяет телефонное устройство, для которого требуется выполнить согласование версии интерфейса.
dwTSPIVersion
Указывает номер версии интерфейса, согласованный для этого устройства с помощью TSPI_phoneNegotiateTSPIVersion. Эта функция работает в соответствии со спецификацией интерфейса на этом уровне версии.
dwLowVersion
Самый низкий номер версии расширения, под которым может работать TAPI или его клиентское приложение. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии.
dwHighVersion
Максимальный номер версии расширения, под которым может работать TAPI или его клиентское приложение. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии.
lpdwExtVersion
Указатель на DWORD. После успешного возврата из этой функции поставщик услуг заполняет это расположение наибольшим номером добавочный номер версии в диапазоне, запрошенном вызывающим элементом, в котором может работать поставщик услуг. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии. Если запрошенный диапазон не перекрывает диапазон, поддерживаемый поставщиком услуг, функция возвращает PHONEERR_INCOMPATIBLEEXTVERSION.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL PHONEERR_NOMEM.
Комментарии
Эту функцию можно вызывать до или после открытия устройства с помощью TAPI. Если устройство открыто и имеет выбранную версию расширения, функция должна вернуть этот номер версии, если он находится в пределах запрошенного диапазона. Если выбранный номер версии выходит за пределы запрошенного диапазона, функция возвращает PHONEERR_INCOMPATIBLEEXTVERSION.
Требования
| Целевая платформа | Windows |
| Header | tspi.h |