функция TSPI_lineSelectExtVersion (tspi.h)
Функция TSPI_lineSelectExtVersion выбирает указанную версию расширения для указанного линейного устройства. Последующие запросы работают в соответствии с этой версией расширения.
Синтаксис
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
Параметры
hdLine
Дескриптор строки, для которой будет выбрана версия расширения.
dwExtVersion
Выбранная версия расширения. Этот номер версии был согласован с помощью TSPI_lineNegotiateExtVersion. Наиболее значимым словом WORD является основной номер версии, а наименее значимым word является дополнительный номер версии. Вызов этой функции с параметром dwExtVersion с нулевым значением отменяет текущее выделение.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL.
Комментарии
Поставщик услуг выбирает указанную версию расширения. Несмотря на то, что указанный номер версии может быть успешно согласован, в промежуточном периоде может быть выбрана другая версия расширения, в этом случае эта функция завершается сбоем (возвращается LINEERR_INCOMPATIBLEEXTVERSION).
Последующие операции в строке после выбора версии расширения ведут себя в соответствии с этой версией расширения. Последующие попытки согласовать версию расширения с строго выбранной версией или 0 (если запрошенный диапазон не включает выбранную версию). Вызов этой процедуры со специальным расширением версии 0 отменяет текущее выделение. Устройство снова становится способным поддерживать полный диапазон номеров дополнительных версий.
Эта функция не имеет прямого соответствия на уровне TAPI, где выбор версии расширения объединяется с другими функциями lineOpen. Функция TSPI_lineSelectExtVersion обычно вызывается в двух ситуациях: (1) приложение запросило открытие строки, изменение типа носителя было успешным, приложение запросило использование определенной версии расширения, и в настоящее время не выбрана версия расширения. (2) Последнее приложение, использующее определенную версию расширения, закрыло строку, и выбор версии расширения можно отменить.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |