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

Справочник по базовым службам телефонии

  • Статья

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

Ниже приведено функциональное группирование базовых функций службы телефонии.

Инициализация и завершение работы TAPI

Функция Описание
lineInitializeEx Инициализирует абстракцию строки TAPI для использования вызывающим приложением. Синхронный.
lineShutdown Завершает работу приложения с использованием абстракции линий TAPI. Синхронный.

 

Согласование версий строк

Функция Описание
lineNegotiateAPIVersion Позволяет приложению согласовывать версию TAPI для использования. Синхронный.

 

Состояние и возможности строки

Функция Описание
lineGetDevCaps Возвращает возможности заданного линейного устройства. Синхронный.
lineGetDevConfig Возвращает конфигурацию устройства потока мультимедиа. Синхронный.
lineGetLineDevStatus Возвращает текущее состояние указанного устройства с открытой линией. Синхронный.
lineSetDevConfig Задает конфигурацию указанного устройства потока мультимедиа. Синхронный.
lineSetStatusMessages Указывает изменения состояния, о которых приложение должно быть уведомлено. Синхронный.
lineGetStatusMessages Возвращает параметры текущей строки и сообщения о состоянии адреса приложения. Синхронный.
lineGetID Извлекает идентификатор устройства, связанный с указанной открытой строкой, адресом или вызовом. Синхронный.
lineGetIcon Позволяет приложению получить значок для отображения пользователю. Синхронный.
lineConfigDialog Вызывает отображение у поставщика указанного линейного устройства диалогового окна, позволяющего пользователю настраивать параметры, связанные с линейным устройством. Синхронный.
lineConfigDialogEdit Отображает диалоговое окно, позволяющее пользователю изменять сведения о конфигурации для линейного устройства. Синхронный.

 

Адреса

Функция Описание
lineGetAddressCaps Возвращает возможности телефонии адреса. Синхронный.
lineGetAddressStatus Возвращает текущее состояние указанного адреса. Синхронный.
lineGetAddressID Извлекает идентификатор адреса, указанного в альтернативном формате. Синхронный.

 

Устройства открывающей и закрывающей линии

Функция Описание
LineОткрыть Открывает указанное устройство линии для последующего мониторинга и (или) управления линией. Синхронный.
LineClose Закрывает указанное открытое устройство строки. Синхронный.

 

Форматы адресов

Функция Описание
lineTranslateAddress Преобразуется между адресом в каноническом формате и адресом в допускаемом для набора формате. Синхронный.
lineSetCurrentLocation Задает расположение, используемое в качестве контекста для преобразования адресов. Синхронный.
lineSetTollList Управляет списком платных сборов. Синхронный.
lineGetTranslateCaps Возвращает возможности преобразования адресов. Синхронный.

 

Состояния и события звонка

Функция Описание
lineGetCallInfo Возвращает фиксированные сведения о вызове. Синхронный.
lineGetCallStatus Возвращает полные сведения о состоянии вызова для указанного вызова. Синхронный.
lineSetAppSpecific Задает зависящее от приложения поле информационной структуры вызова. Синхронный.

 

Совершение звонков

Функция Описание
lineMakeCall Выполняет исходящий вызов и возвращает для него дескриптор вызова. Асинхронная.
lineDial Наборы (части одного или нескольких) набираемых адресов. Асинхронная.

 

Ответы на входящие звонки

Функция Описание
lineAnswer Отвечает на входящий звонок. Асинхронная.

 

Поддержка средства сохранения платных сборов

Функция Описание
lineSetNumRings Указывает количество кругов, после которых должны быть ответы на входящие звонки. Синхронный.
lineGetNumRings Возвращает минимальное количество колец, запрошенных с помощью lineSetNumRings. Синхронный.

 

Управление привилегиями вызова

Функция Описание
lineSetCallPrivilege Задает для приложения указанное разрешение. Синхронный.

 

Вызов функций удаления

Функция Описание
lineDrop Отключает вызов или отказывается от попытки вызова. Асинхронная.
lineDeallocateCall Освобождает указанный дескриптор вызова. Синхронный.

 

Манипуляция с дескриптором вызовов

Функция Описание
lineHandoff Передает права владения вызовом и /или изменяет привилегии приложения на вызов. Синхронный.
lineGetNewCalls Возвращает дескрипторы вызовов по указанной строке или адресу, для которых приложение еще не имеет дескрипторов. Синхронный.
lineGetConfRelatedCalls Возвращает список дескрипторов вызовов, которые являются частью той же конференции, что и вызов, указанный в качестве параметра. Синхронный.

 

Сведения о расположении и стране или регионе

Функция Описание
lineTranslateDialog Отображает диалоговое окно, позволяющее пользователю изменять расположение и вызывать карта сведения. Синхронный.
lineGetCountry Извлекает правила набора номера и другие сведения об определенной стране или регионе. Синхронный.

 

Запрос служб получателей

Следующие две функции используются только для поддержки вспомогательной телефонии.

Функция Описание
lineRegisterRequestRecipient Регистрирует или отменяет регистрацию приложения в качестве получателя запроса для указанного режима запроса. Синхронный.
lineGetRequest Возвращает следующий запрос из библиотеки динамической компоновки телефонии. Синхронный.