LINE_CALLINFO сообщение

Сообщение LINE_CALLINFO TAPI отправляется при изменении сведений об указанном вызове. Приложение может вызвать lineGetCallInfo для определения текущих сведений о вызове.

            

Параметры

hDevice

Дескриптор для вызова.

dwCallbackInstance

Экземпляр обратного вызова, указанный при открытии строки вызова.

dwParam1

Измененный элемент сведений о вызове. Может быть одной или несколькими константами LINECALLINFOSTATE_.

dwParam2

Не используется.

dwParam3

Не используется.

Возвращаемое значение

Нет возвращаемого значения.

Комментарии

Сообщение LINE_CALLINFO с указанием NumOwnersIncr, NumOwnersDecr и(или) NumMonitorsChanged отправляется приложениям, у которых уже есть дескриптор для вызова. Это может быть результатом смены другого приложения владельца или мониторинга на вызов с помощью lineOpen, lineClose, lineShutdown, lineSetCallPrivilege, lineGetNewCalls и lineGetConfRelatedCalls.

Эти LINE_CALLINFO сообщения не отправляются при предоставлении уведомления о новом звонке в LINE_CALLSTATE сообщении, так как сведения о звонке уже отражают правильное количество владельцев и мониторов на момент отправки LINE_CALLSTATE сообщений. LINE_CALLINFO сообщения также подавляются в случае, когда TAPI предлагает вызов мониторам через механизм LINECALLSTATE_UNKNOWN.

Примечание

Приложение, которое вызывает изменение числа владельцев или мониторов (например, путем вызова lineDeallocateCall или lineSetCallPrivilege), само не получает сообщение о том, что изменение было выполнено.

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

Требования

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

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

lineClose

lineDeallocateCall

lineGetCallInfo

lineGetConfRelatedCalls

lineGetNewCalls

LineOpen

lineSetCallPrivilege

lineShutdown