Управление устройствами (API телефонии)

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

К ключевым категориям устройств относятся:

  • сетевой: уровень транспорта для связи. С точки зрения приложения сведения о сети обычно внедряются в тип адреса, например LINEADDRESSTYPE_PHONENUMBER.
  • строка: подключение к сети. Эта концепция широко используется в TAPI 2.2 (TAPI/C).
  • канал: подразделение линии. Знание каналов обычно не требуется приложению, так как поставщик услуг настраивает, как они будут отображаться в качестве адресов.
  • адрес: сетевое расположение в сети. Каждая строка или канал имеют один или несколько связанных адресов. Адрес является ключевым понятием в TAPI 3.1 (TAPI/COM) и TAPI 2.2 (TAPI/C).
  • терминале: источник или отрисовщик для определенного адреса и типа мультимедиа.

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

Основные характеристики устройства:

Кроме того, поставщики услуг предоставляют сведения о емкости заданного адреса для выполнения различных операций сеанса.

Дополнительные характеристики могут быть связаны с определенными устройствами, если поставщики услуг поддерживают их. Приложение TAPI 2.x обнаруживает возможности с помощью функций lineGetDevCaps и lineGetAddressCaps. Приложения TAPI 3.x используют интерфейс ITAddressCapabilities для этой цели.

TAPI 2.x предоставляет специальный набор дополнительных операций, которые поставщик услуг может реализовать для использования с телефонными устройствами. См. телефонных устройств.

Расширенные возможности зависят от поставщика и не охватываются API телефонии Майкрософт. См. расширенные функции, расширенные функции телефонной связиили интерфейсы Provider-Specific.

Ниже приведена сводка операций TAPI, которые запрашивают поставщиков услуг на характеристики устройства и предоставляют данные о текущем состоянии.

Функции TAPI 2.x Описание
lineGetDevCaps Запрашивает указанное устройство строки для определения возможностей телефонии связанных адресов.
lineGetAddressCaps Запрашивает указанное устройство строки для определения возможностей телефонии конкретного адреса.
lineGetDevConfig Возвращает непрозрачную структуру данных, которая хранит текущую конфигурацию устройства.
lineSetDevConfig Восстанавливает конфигурацию устройства.
lineConfigDialog Отображение диалогового окна, позволяющего пользователю настраивать параметры, связанные с устройством.
lineGetID Извлекает стабильный идентификатор устройства, который можно использовать в последующих вызовах функций TAPI или с другим API.
lineGetLineDevStatus Запрашивает устройство для текущего состояния, например количество активных вызовов.
lineSetLineDevStatus Задает состояние устройства, например задание устройства как не в службе.
lineGetIcon Извлекает значок конкретного поставщика для отображения пользователю.
lineNegotiateExtVersion Позволяет приложению согласовывать версию расширения, используемую с указанным устройством строки.
lineDevSpecific Предоставляет доступ к функциям, зависящим от устройства.
lineDevSpecificFeature Отправляет функции, относящиеся к устройству, поставщику услуг.

 

Интерфейсы или методы TAPI 3.x Описание
ITAddressCapabilities Получает сведения о возможностях адреса.
ITAMMediaFormat Задает и получает формат мультимедиа DirectShow™.
ITBasicAudioTerminal Задает и получает стандартные характеристики звукового терминала, такие как том.
ITMediaSupport Получает сведения о возможностях поддержки мультимедиа адреса.
ITTerminal Базовый интерфейс для объекта Терминала. Получает такие сведения, как класс терминала и поддерживаемые носители.
ITTerminalSupport Получает сведения о доступных терминалах и создает дополнительные терминалы.
интерфейсовProvider-Specific Поставщик услуг зависит.