Основные функции телефонии TSPI

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

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

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

Функция	Описание
TUISPI_providerInstall	Устанавливает TSP. Синхронный.
TSPI_providerInstall	Устанавливает TSP. Устарело с версией 2.0. Синхронный.
TSPI_providerInit	Инициализирует TSP. Синхронный.
TSPI_providerShutdown	Завершает работу поставщика услуг.
TUISPI_providerRemove	Удаляет TSP. Синхронный.
TSPI_providerRemove	Удаляет TSP. Устарело с версией 2.0. Синхронный.

 

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

Функция	Описание
TSPI_phoneNegotiateTSPIVersion	Возвращает самую высокую версию SPI, в которой поставщик услуг может работать для этого устройства.

 

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

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

 

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

Функция	Описание
TSPI_lineGetDevCaps	Возвращает возможности заданного устройства строки. Синхронный.
TSPI_lineGetDevConfig	Возвращает конфигурацию устройства потока мультимедиа. Синхронный.
TSPI_lineGetLineDevStatus	Возвращает текущее состояние указанного устройства открытой строки. Синхронный.
TSPI_lineSetDevConfig	Задает конфигурацию указанного устройства потока мультимедиа. Синхронный.
TSPI_lineSetStatusMessages	Указывает изменения состояния, для которых приложение должно быть уведомлено. Синхронный.
TSPI_lineGetID	Извлекает идентификатор устройства, связанный с указанной открытой строкой, адресом или вызовом. Синхронный.
TSPI_lineGetIcon	Позволяет приложению получить значок для отображения пользователю. Синхронный.
TUISPI_lineConfigDialog	Приводит к отображению диалогового окна поставщика указанного устройства строки, позволяющего пользователю настраивать параметры, связанные с устройством линии. Синхронный.
TUISPI_lineConfigDialogEdit	Отображает диалоговое окно, позволяющее пользователю изменять сведения о конфигурации для устройства линии. Синхронный.

 

Адреса

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

 

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

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

 

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

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

 

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

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

 

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

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

 

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

Функция	Описание
TSPI_lineDrop	Отключает вызов или отменяет попытку вызова. Асинхронный.