Функция lineDevSpecificFeature (tapi.h)
Функция lineDevSpecificFeature позволяет поставщикам услуг предоставлять доступ к функциям, не предлагаемым другими функциями TAPI. Значение этих расширений зависит от устройства, и для использования этих расширений требуется, чтобы приложение полностью знало о них.
Синтаксис
LONG lineDevSpecificFeature(
HLINE hLine,
DWORD dwFeature,
LPVOID lpParams,
DWORD dwSize
);
Параметры
hLine
Дескриптор на линейное устройство.
dwFeature
Функция для вызова на устройстве строки. Этот параметр использует константы PHONEBUTTONFUNCTION_.
lpParams
Указатель на область памяти, используемую для хранения блока параметров, зависящей от функций. Формат этого блока параметров зависит от устройства, и его содержимое передается через TAPI поставщику услуг или от него.
dwSize
Размер буфера в байтах.
Возвращаемое значение
Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения LINE_REPLY равен нулю при успешном выполнении функции или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALFEATURE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM LINEERR_UNINITIALIZED.
Дополнительные возвращаемые значения зависят от устройства.
Комментарии
Эта операция является частью служб расширенной телефонии. Он предоставляет доступ к функции для конкретного устройства, не определяя ее значение. Эта операция доступна, только если приложение успешно согласует версию расширения для конкретного устройства.
Эта функция предоставляет приложению возможности эмуляции кнопок функции телефона. Когда приложение вызывает эту операцию, оно указывает эквивалент события нажатия кнопки. Этот метод вызова функций зависит от устройства, так как TAPI не определяет их значение. Как правило, приложение, использующее эти расширения для устройств, не работает с другими средами поставщиков услуг.
Структура, на которую указывает lpParams , не должна содержать указателей, так как они не будут должным образом переведены (отложены) при запуске 16-разрядного приложения в 32-разрядной версии TAPI и наоборот.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |