Share via

Константы LINEDEVSTATE_

  • Статья

Константы битового флага LINEDEVSTATE_ описывают различные события состояния строк.

LINEDEVSTATE_BATTERY

Уровень заряда батареи значительно изменился (сотовая сеть).

LINEDEVSTATE_CAPSCHANGE

Указывает, что из-за изменений конфигурации, внесенных пользователем или другими обстоятельствами, один или несколько элементов в структуре LINEDEVCAPS для адреса были изменены. Приложение должно использовать lineGetDevCaps для чтения обновленной структуры. Если поставщик услуг отправляет в TAPI сообщение LINE_LINEDEVSTATE , содержащее это значение, TAPI передает его приложениям, для которых была согласована версия TAPI 1.4 или более поздняя; Приложения, которые согласовывают предыдущую версию TAPI, будут получать LINE_LINEDEVSTATE сообщения с указанием LINEDEVSTATE_REINIT, требуя от них завершения работы и повторной инициализации подключения к TAPI для получения обновленных сведений.

LINEDEVSTATE_CLOSE

Линия была закрыта другим приложением.

LINEDEVSTATE_CONFIGCHANGE

Указывает, что на одном или нескольких устройствах мультимедиа, связанных с устройством линии, были внесены изменения в конфигурацию. При необходимости приложение может использовать lineGetDevConfig для чтения обновленных сведений. Если поставщик услуг отправляет в TAPI сообщение LINE_LINEDEVSTATE , содержащее это значение, TAPI передает его приложениям, для которых была согласована версия TAPI 1.4 или более поздняя; Приложения, которые согласовывают предыдущую версию API, не будут получать никаких уведомлений.

LINEDEVSTATE_COMPLCANCEL

Указывает, что завершение вызова, определенное идентификатором завершения, содержащимся в параметре dwParam2сообщения LINE_LINEDEVSTATE , было отменено извне и больше не считается допустимым (если это значение должно было быть передано в последующем вызове lineUncompleteCall, функция завершится сбоем с LINEERR_INVALCOMPLETIONID). Если поставщик услуг отправляет в TAPI сообщение LINE_LINEDEVSTATE , содержащее это значение, TAPI передает его приложениям, для которых была согласована версия TAPI 1.4 или более поздняя; Приложения, которые согласовывают предыдущую версию API, не будут получать никаких уведомлений.

LINEDEVSTATE_CONNECTED

Ранее линия была отключена и теперь подключена к TAPI.

LINEDEVSTATE_DEVSPECIFIC

Сведения об устройстве линии изменились.

LINEDEVSTATE_DISCONNECTED

Эта линия была ранее подключена и теперь отключена от TAPI.

LINEDEVSTATE_INSERVICE

Линия подключена к TAPI. Это происходит при первой активации TAPI или при физическом подключении и обслуживании линии на коммутаторе во время активности TAPI.

LINEDEVSTATE_LOCK

Состояние заблокированного устройства изменилось. (Дополнительные сведения см. в разделе LINEDEVSTATUSFLAGS_LOCKED в константах LINEDEVSTATUSFLAGS_.)

LINEDEVSTATE_MAINTENANCE

Обслуживание выполняется в строке на коммутаторе. TAPI нельзя использовать для работы на устройстве линии.

LINEDEVSTATE_MSGWAITOFF

Индикатор ожидания сообщения отключен.

LINEDEVSTATE_MSGWAITON

Индикатор ожидания сообщения включен.

LINEDEVSTATE_NUMCALLS

Количество вызовов на устройстве линии изменилось.

LINEDEVSTATE_NUMCOMPLETIONS

Количество незавершенных завершений вызовов на устройстве линии изменилось.

LINEDEVSTATE_OPEN

Линия открыта другим приложением.

LINEDEVSTATE_OTHER

Элементы состояния устройства, отличные от перечисленных ниже, изменились. Приложение должно проверка текущее состояние устройства, чтобы определить, какие элементы были изменены.

LINEDEVSTATE_OUTOFSERVICE

Линия не работает на коммутаторе или физически отключена. TAPI нельзя использовать для работы на устройстве линии.

LINEDEVSTATE_REINIT

В конфигурации линейных устройств были изменены элементы. Чтобы узнать об этих изменениях (в отношении появления новых устройств линии), приложение должно повторно инициализировать использование TAPI.

LINEDEVSTATE_REMOVED

Указывает, что устройство удаляется из системы поставщиком услуг (скорее всего, с помощью действий пользователя, через панель управления или аналогичную служебную программу). За LINE_LINEDEVSTATE сообщением с этим значением, как правило, сразу последует LINE_CLOSE сообщение на устройстве. Последующие попытки получить доступ к устройству до повторной инициализации TAPI приведут к возвращению LINEERR_NODEVICE в приложение. Если поставщик услуг отправляет в TAPI сообщение LINE_LINEDEVSTATE , содержащее это значение, TAPI передает его приложениям, для которых была согласована версия TAPI 1.4 или более поздняя; Приложения, которые согласовывают предыдущую версию API, не будут получать никаких уведомлений.

LINEDEVSTATE_RINGING

Переключатель сообщает строке, что пользователь оповещает.

TAPI: Поставщики услуг уведомляют приложения о каждом цикле кругов, многократно отправляя LINE_LINEDEVSTATE сообщения, содержащие эту константу. Например, в США поставщики услуг отправляют сообщение с этой константой каждые шесть секунд.

TSPI: На устройстве POTS поставщик услуг может отправлять сообщение всякий раз, когда центральный офис отправляет напряжение звонка. На цифровых устройствах, таких как ISDN, поставщику услуг может потребоваться синтезировать повторение сообщения, если переключатель создает только один кольцевой запрос. При каждом повторении сообщения должно отображаться увеличение числа колец, чтобы функции сохранения платы работали правильно.

LINEDEVSTATE_ROAMMODE

Режим роуминга для устройства линии изменился.

LINEDEVSTATE_SIGNAL

Уровень сигнала значительно изменился (сотовая связь).

LINEDEVSTATE_TERMINALS

Параметры терминала изменились. Это может произойти, например, если несколько линейных устройств совместно используют между собой терминалы (например, две линии, совместно использующие телефонный терминал).

LINEDEVSTATE_TRANSLATECHANGE

Указывает, что из-за изменений конфигурации, внесенных пользователем или другими обстоятельствами, один или несколько элементов в структуре LINETRANSLATECAPS были изменены . Приложение должно использовать lineGetTranslateCaps для чтения обновленной структуры. Если поставщик услуг отправляет в TAPI сообщение LINE_LINEDEVSTATE , содержащее это значение, TAPI передает его приложениям, для которых была согласована версия TAPI 1.4 или более поздняя; Приложения, которые согласовывают предыдущую версию TAPI, будут получать LINE_LINEDEVSTATE сообщения с указанием LINEDEVSTATE_REINIT, требуя от них завершения работы и повторной инициализации подключения к TAPI для получения обновленных сведений.

Комментарии

Расширяемость отсутствует. Все 32 бита зарезервированы.

Требования

Требование Значение
Версия TAPI
 Требуется TAPI 2.0 или более поздней версии
Заголовок
Tapi.h

См. также раздел

LINE_CLOSE

LINE_LINEDEVSTATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

LINETRANSLATECAPS

lineUncompleteCall