Поделиться через

функция TSPI_lineDevSpecificFeature (tspi.h)

  • Статья

Функция TSPI_lineDevSpecificFeature используется в качестве механизма расширения для предоставления поставщикам услуг доступа к функциям, не описанным в других операциях. Значения этих расширений зависят от устройства, и для использования этих расширений необходимо, чтобы TAPI или его клиентское приложение были полностью осведомлены о них.

Синтаксис

LONG TSPIAPI TSPI_lineDevSpecificFeature(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwFeature,
  LPVOID        lpParams,
  DWORD         dwSize
);

Параметры

dwRequestID

Идентификатор асинхронного запроса.

hdLine

Дескриптор поставщика услуг для устройства линии.

dwFeature

Функция, вызываемая на устройстве линии. Этот параметр использует PHONEBUTTONFUNCTION_ константы.

lpParams

Указатель на область памяти, используемую для хранения блока параметров, зависимых от функций. Формат этого блока параметров зависит от устройства.

dwSize

Размер буфера в байтах. Если параметр lpParams является указателем на строку, размер должен включать признак конца null.

Возвращаемое значение

Возвращает dwRequestID или номер ошибки при возникновении ошибки. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM LINEERR_RESOURCEUNAVAIL.

Комментарии

Дополнительные возвращаемые значения зависят от устройства. Состояние вызова hdCall зависит от устройства.

Эта функция предоставляет приложениям TAPI возможности эмуляции кнопки функции телефона. Когда TAPI вызывает эту операцию от имени клиентского приложения, он указывает эквивалент события нажатия кнопки. Этот метод вызова функций в значительной степени зависит от устройства, так как API не определяет их значение. Если приложение использует расширения для конкретного устройства, приложение не переносит его в другие среды поставщика услуг.

Эта функция вызывается в прямой ответ на то, что приложение вызывает функцию TAPI lineDevSpecificFeature . TAPI преобразует параметр hLine , используемый на уровне TAPI, в соответствующий параметр hdLine , используемый на уровне TSPI. Буфер lpParams передается через неизмененный.

Примечание Структура данных lpParams не должна содержать указателей, так как они неправильно преобразуются (преобразовываются) при запуске 16-разрядного приложения в 32-разрядной версии TAPI и наоборот.
 
Эта операция является частью служб расширенной телефонии. Он предоставляет доступ только к функции конкретного устройства, не определяя ее значение. Эта операция доступна только в том случае, если TAPI успешно согласовалась и выбрала версию расширения для конкретного устройства.

Требования

Требование Значение
Целевая платформа Windows
Header tspi.h

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

ASYNC_COMPLETION

LINE_DEVSPECIFICFEATURE

Константы PHONEBUTTONFUNCTION_