функция TSPI_lineNegotiateTSPIVersion (tspi.h)
Функция TSPI_lineNegotiateTSPIVersion возвращает самую высокую версию SPI, в которой поставщик услуг может работать для этого устройства, учитывая диапазон возможных версий SPI.
Синтаксис
LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Параметры
dwDeviceID
Идентифицирует устройство линии, для которого требуется выполнить согласование версии интерфейса. Помимо идентификаторов устройств в диапазоне, который поддерживает поставщик услуг, это может быть значение:
INITIALIZE_NEGOTIATION
Это значение используется для обозначения согласования общей версии интерфейса.
dwLowVersion
Самый низкий номер версии TSPI, под которым может работать TAPI. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии.
dwHighVersion
Самый высокий номер версии TSPI, под которым может работать TAPI. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии.
lpdwTSPIVersion
Указатель на DWORD. Поставщик услуг заполняет это расположение самым высоким номером версии TSPI в диапазоне, запрашиваемом вызывающим абонентом, в котором может работать поставщик услуг. Наиболее значимым словом WORD является основной номер версии, а наименее значимым — дополнительный номер версии. Если запрошенный диапазон не перекрывает диапазон, поддерживаемый поставщиком услуг, функция возвращает LINEERR_INCOMPATIBLEAPIVERSION.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Комментарии
Если параметр dwDeviceIDINITIALIZE_NEGOTIATION, эта функция не должна возвращать LINEERR_OPERATIONUNAVAIL, так как эта функция (с этим значением) является обязательной для согласования общей версии интерфейса, даже если поставщик услуг не поддерживает линейные устройства.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |