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

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

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

• Форматы адресов
• Адреса
• Ответы на входящие звонки
• Вызов функций удаления
• Обработка дескрипторов вызовов
• Управление привилегиями вызовов
• Состояния и события звонков
• Состояние и возможности строки
• Согласование версий строк
• Сведения о местоположении и стране или регионе
• Совершение вызовов
• Устройства открывающей и закрывающей линии
• Запрос служб получателей
• Инициализация и завершение работы TAPI
• Поддержка средства сохранения платных сборов

Инициализация и завершение работы 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	Возвращает следующий запрос из библиотеки динамической компоновки телефонии. Синхронный.