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

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

LINE_CLOSE

LINE_CREATE

LINEDEVCAPS

lineGetDevCaps

lineGetDevConfig

lineGetTranslateCaps

lineInitialize

LineOpen

lineSetStatusMessages

lineShutdown

LINETRANSLATECAPS

lineUncompleteCall