сообщение PHONE_STATE
TAPI отправляет PHONE_STATE сообщение в приложение при изменении состояния телефонного устройства.
Параметры
-
hPhone
-
Дескриптор для телефонного устройства.
-
dwCallbackInstance
-
Экземпляр обратного вызова приложения, указанный при открытии телефонного устройства.
-
dwParam1
-
Измененное состояние телефона. Этот параметр использует одну из констант PHONESTATE_.
-
dwParam2
-
Сведения, зависящие от состояния телефона, с подробным описанием изменения состояния. Этот параметр не используется, если в dwParam1 задано несколько флагов, так как несколько элементов состояния изменились. Приложение должно вызвать phoneGetStatus для получения полного набора сведений.
Если параметр dwParam1 PHONESTATE_OWNER, dwParam2 содержит новое число владельцев.
Если параметр dwParam1 PHONESTATE_MONITORS, dwParam2 содержит новое количество мониторов.
Если параметр dwParam1 PHONESTATE_LAMP, dwParam2 содержит идентификатор кнопки или лампы для измененного фонаря.
Если параметр dwParam1 PHONESTATE_RINGMODE, dwParam2 содержит новый кольцевой режим.
Если dwParam1 имеет значение PHONESTATE_HANDSET, SPEAKER или HEADSET, dwParam2 содержит новый режим перехватчика этого устройства-перехватчика. Этот параметр использует одну из констант PHONEHOOKSWITCHMODE_.
-
dwParam3
-
Не используется.
Возвращаемое значение
Нет возвращаемого значения.
Комментарии
Отправкой PHONE_STATE сообщения в приложение можно управлять и запрашивать с помощью phoneSetStatusMessages и phoneGetStatusMessages. По умолчанию это сообщение отключено для всех изменений состояния, кроме PHONESTATE_REINIT, которые нельзя отключить. Это сообщение отправляется всем приложениям, имеющим дескриптор на телефоне, включая приложения, которые вызвали phoneОткрыть с параметром dwPrivileges , для параметра PHONEPRIVILEGE_OWNER или PHONEPRIVILEGE_MONITOR.
В приложения, у которых уже есть дескриптор для телефона, отправляется сообщение PHONE_STATE с указанием "Владельцы" и (или) "Мониторы". Это может быть результатом смены владельца или мониторинга другого приложения на телефонном устройстве с phoneOpen, phoneClose или phoneShutdown.
Требования
| Требование | Значение |
|---|---|
| Версия TAPI |
Требуется TAPI 2.0 или более поздней версии |
| Заголовок |
|