LINE_APPNEWCALL сообщение

Сообщение TAPI LINE_APPNEWCALL отправляется для информирования приложения о том, что новый дескриптор вызова был автоматически создан от его имени (кроме вызова API из приложения, в этом случае дескриптор был бы возвращен через параметр указателя, переданный в функцию).

Параметры

hDevice

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

dwCallbackInstance

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

dwParam1

Идентификатор адреса в строке, по которой появляется вызов. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

dwParam2

Дескриптор приложения к новому вызову.

dwParam3

Права доступа приложений к новому вызову (LINECALLPRIVILEGE_OWNER или LINECALLPRIVILEGE_MONITOR).

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

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

Комментарии

Приложения, поддерживающие TAPI версии 2.0 или более поздней, отправляют LINE_APPNEWCALL сообщение всякий раз, когда приложению автоматически присваивается дескриптор нового вызова. Так как сообщение содержит параметры hLine и dwAddressID , в которых существует вызов, приложение может легко создать новый объект вызова в правильном контексте. За сообщением LINE_APPNEWCALL всегда сразу же следует LINE_CALLSTATE сообщение, указывающее начальное состояние вызова.

Старые приложения (которые согласовывали версию API до 2.0) отправляют только LINE_CALLSTATE сообщение, как описано в предыдущих версиях API. Такие приложения создают новый объект вызова после получения сообщения LINE_CALLSTATE , для которого dwParam3 задано ненулевое значение и содержит дескриптор вызова, который в настоящее время не известен приложению. Недостатки: (a) приложение должно вызывать lineGetCallInfo для определения параметров hLine и dwAddressID , связанных с вызовом; (б) приложение должно сканировать все известные дескрипторы вызовов, чтобы определить, что вызов является новым вызовом; и (в) при определенных условиях приложение может думать, что оно получает новый дескриптор вызова, когда на самом деле оно только что освободило свой дескриптор вызова (например, приложение только что освободило дескриптор вызова, но LINE_CALLSTATE сообщение, предоставляющее приложению право собственности на вызов из-за lineHandoff из другого приложения, уже находилось в очереди сообщений TAPI приложения).

Требования

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

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

LINE_CALLSTATE

lineGetCallInfo

lineHandoff