messaggio LINE_APPNEWCALL
Il messaggio TAPI LINE_APPNEWCALL viene inviato per informare un'applicazione quando un nuovo handle di chiamata è stato creato spontaneamente per suo conto (diverso da una chiamata API dall'applicazione, nel qual caso l'handle sarebbe stato restituito tramite un parametro puntatore passato alla funzione).
Parametri
-
hDevice
-
Handle dell'applicazione nel dispositivo linea in cui è stata creata la chiamata.
-
dwCallbackInstance
-
Istanza di callback fornita quando si apre la riga della chiamata.
-
dwParam1
-
Identificatore dell'indirizzo nella riga in cui viene visualizzata la chiamata. Un identificatore di indirizzo è associato definitivamente a un indirizzo; l'identificatore rimane costante tra gli aggiornamenti del sistema operativo.
-
dwParam2
-
Handle dell'applicazione alla nuova chiamata.
-
dwParam3
-
Privilegi delle applicazioni per la nuova chiamata (LINECALLPRIVILEGE_OWNER o LINECALLPRIVILEGE_MONITOR).
Valore restituito
Nessun valore restituito.
Commenti
Le applicazioni che supportano TAPI versione 2.0 o successiva vengono inviate un messaggio LINE_APPNEWCALL ogni volta che l'applicazione viene assegnata spontaneamente un handle a una nuova chiamata. Poiché il messaggio include i parametri hLine e dwAddressID in cui esiste la chiamata, l'applicazione può facilmente creare un nuovo oggetto call nel contesto corretto. Il messaggio LINE_APPNEWCALL viene sempre seguito immediatamente da un messaggio LINE_CALLSTATE che indica lo stato iniziale della chiamata.
Le applicazioni meno recenti (che hanno negoziato una versione API precedente alla versione 2.0) vengono inviate solo un messaggio di LINE_CALLSTATE , come documentato nelle versioni precedenti dell'API. Tali applicazioni creerebbero un nuovo oggetto call quando riceve un messaggio di LINE_CALLSTATE con dwParam3 impostato su un valore diverso da zero e contenente un handle di chiamata non attualmente noto dall'applicazione. Gli svantaggi sono che (a) l'applicazione deve chiamare lineGetCallInfo per determinare i parametri hLine e dwAddressID associati alla chiamata; (b) l'applicazione deve analizzare tutti gli handle di chiamate noti per determinare che la chiamata è una nuova chiamata; e (c) è possibile, in determinate condizioni, per l'applicazione pensare che riceva un nuovo handle di chiamata quando in realtà ha appena deallocato il relativo handle alla chiamata (ad esempio, l'applicazione ha appena deallocato un handle di chiamata, ma un messaggio di LINE_CALLSTATE che dà la proprietà dell'applicazione della chiamata a causa di una rigaHandoff da un'altra applicazione era già presente nella coda di messaggi TAPI dell'applicazione).
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|