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