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

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

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

• форматы адресов
• адреса
• ответа на входящие вызовы
• функции удаления вызовов
• обработки вызовов
• управления привилегиями вызовов
• состояния вызовов и события
• состояние строки и возможности
• согласование версий
• сведения о расположении и регионе
• вызовы
• открытие и закрытие устройств линии
• запрашивать службы получателей
• инициализации и завершения работы TAPI
• Поддержка с сохранением платных сборок

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

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

 

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

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

 

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

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

 

Адреса

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

 

Открытие и закрытие устройств линии

Функция	Описание
lineOpen	Открывает указанное устройство строки для последующего мониторинга и /или управления линией. Синхронный.
lineClose	Закрывает указанное открытое устройство строки. Синхронный.

 

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

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

 

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

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

 

Выполнение вызовов

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

 

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

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

 

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

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

 

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

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

 

Функции удаления вызовов

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

 

Обработка дескриптора вызовов

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

 

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

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

 

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

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

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