сообщение 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 или более поздней версии
Заголовок	Tapi.h

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

PHONE_CLOSE

PHONECAPS

phoneClose

phoneGetDevCaps

phoneGetStatus

phoneGetStatusMessages

phoneInitialize

phoneInitializeEx

phoneОткрыть

phoneSetStatusMessages

phoneShutdown