LINE_LINEDEVSTATE сообщение
Сообщение LINE_LINEDEVSTATE TAPI отправляется при изменении состояния линейного устройства. Приложение может вызвать lineGetLineDevStatus , чтобы определить новое состояние строки.
Параметры
-
hDevice
-
Дескриптор для устройства линии. Этот параметр имеет значение NULL , если dwParam1 имеет значение LINEDEVSTATE_REINIT.
-
dwCallbackInstance
-
Экземпляр обратного вызова, указанный при открытии строки. Если параметр dwParam1 имеет LINEDEVSTATE_REINIT, параметр dwCallbackInstance недопустим и имеет значение 0.
-
dwParam1
-
Измененный элемент состояния линейного устройства. Параметр может быть одной или несколькими константами LINEDEVSTATE_.
-
dwParam2
-
Интерпретация этого параметра зависит от значения dwParam1. Если параметр dwParam1 LINEDEVSTATE_RINGING, dwParam2 содержит кольцевой режим, с помощью которого переключатель указывает, что строка будет звонить. Допустимые режимы кругов — это числа в диапазоне от одного до dwNumRingModes, где dwNumRingModes — это возможность линейного устройства.
Если параметр dwParam1 LINEDEVSTATE_REINIT и сообщение было выдано TAPI в результате перевода нового сообщения API в сообщение REINIT, то dwParam2 содержит параметр dwMsg исходного сообщения (например, LINE_CREATE или LINE_LINEDEVSTATE). Если значение dwParam2 равно нулю, это означает, что сообщение REINIT является "реальным" сообщением REINIT, требующим от приложения вызова lineShutdown в кратчайшие сроки.
-
dwParam3
-
Интерпретация этого параметра зависит от значения dwParam1. Если параметр dwParam1 LINEDEVSTATE_RINGING, dwParam3 содержит число кругов для этого события кольца. Число колец начинается с нуля.
Если параметр dwParam1 LINEDEVSTATE_REINIT и сообщение было выдано TAPI в результате преобразования нового сообщения API в сообщение REINIT, то dwParam3 содержит параметр dwParam1 исходного сообщения (например, LINEDEVSTATE_TRANSLATECHANGE или другое значение LINEDEVSTATE_, если dwParam2 — LINE_LINEDEVSTATE, или новый идентификатор устройства, если dwParam2 — LINE_CREATE).
Возвращаемое значение
Нет возвращаемого значения.
Комментарии
Отправкой сообщения LINE_LINEDEVSTATE можно управлять с помощью lineSetStatusMessages. Приложение может указать изменения элементов состояния, о которых оно хочет получать уведомления. По умолчанию все отчеты о состоянии отключены, за исключением LINEDEVSTATE_REINIT, которые нельзя отключить. Это сообщение отправляется всем приложениям, у которых есть дескриптор строки, включая те, которые вызвали lineOpen с параметром dwPrivileges, для параметра dwPrivileges задано значение LINECALLPRIVILEGE_NONE, LINECALLPRIVILEGE_OWNER, LINECALLPRIVILEGE_MONITOR или разрешенные сочетания этих строк.
Требования
| Требование | Значение |
|---|---|
| Версия TAPI |
Требуется TAPI 2.0 или более поздней версии |
| Заголовок |
|