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