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

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

INITIALIZE_NEGOTIATION

TSPI_phoneGetExtensionID

TSPI_phoneNegotiateExtVersion