messaggio LINE_CALLSTATE
Il messaggio TAPI LINE_CALLSTATE viene inviato quando lo stato della chiamata specificata è cambiato. In genere, durante la durata di una chiamata vengono ricevuti diversi messaggi di questo tipo. Le applicazioni ricevono una notifica di nuove chiamate in ingresso con questo messaggio; la nuova chiamata si trova nello stato dell'offerta . L'applicazione può usare lineGetCallStatus per recuperare informazioni più dettagliate sullo stato corrente della chiamata.
Parametri
-
hDevice
-
Handle per la chiamata.
-
dwCallbackInstance
-
Istanza di callback fornita quando si apre la riga della chiamata.
-
dwParam1
-
Nuovo stato di chiamata. Questo parametro deve essere uno e solo una delle costanti LINECALLSTATE_ seguenti.
dwParam1 Significato - LINECALLSTATE_BUSY
dwParam2 contiene dettagli sulla modalità occupato. Questo parametro usa una delle costanti LINEBUSYMODE_. - LINECALLSTATE_CONNECTED
dwParam2 contiene informazioni dettagliate sulla modalità connessa. Questo parametro usa una delle costanti LINECONNECTEDMODE_. - LINECALLSTATE_DIALTONE
dwParam2 contiene informazioni dettagliate sulla modalità tono di chiamata. Questo parametro usa una delle costanti LINEDIALTONEMODE_. - LINECALLSTATE_OFFERING
dwParam2 contiene informazioni dettagliate sulla modalità connessa. Questo parametro usa una delle costanti LINEOFFERINGMODE_. - LINECALLSTATE_SPECIALINFO
dwParam2 contiene i dettagli sulla modalità informazioni speciali. Questo parametro usa una delle costanti LINESPECIALINFO_. - LINECALLSTATE_DISCONNECTED
dwParam2 contiene informazioni dettagliate sulla modalità disconnessione. Questo parametro usa una delle costanti LINEDISCONNECTMODE_. -
dwParam2
-
Informazioni dipendenti dallo stato della chiamata. Vedere dwParam1.
Nota
In circostanze in cui è appropriata una risposta ritardata , usare LINEDISCONNECTMODE_TEMPFAILURE. Se è appropriata una risposta in blocco , usare LINEDISCONNECT_BLOCKED. Per altre informazioni, vedere costanti LINEDISCONNECTMODE_.
Se dwParam1 è LINECALLSTATE_CONFERENCED, dwParam2 contiene il parametro hConfCall della chiamata padre della conferenza di cui il soggetto hCall è membro. Se la chiamata specificata in dwParam2 non è stata considerata in precedenza dall'applicazione come chiamata padre (hConfCall, l'applicazione deve farlo come risultato di questo messaggio. Se l'applicazione non dispone di un handle per la chiamata padre della conferenza (perché in precedenza ha chiamato lineDeallocateCall su tale handle) dwParam2 è impostata su NULL.
-
dwParam3
-
Se zero, questo parametro indica che non è stata apportata alcuna modifica al privilegio dell'applicazione per la chiamata.
Se non è zero, specifica il privilegio dell'applicazione per la chiamata. Ciò si verifica nelle situazioni seguenti: (1) La prima volta che l'applicazione viene assegnato un handle a questa chiamata; (2) Quando l'applicazione è la destinazione di un handoff di chiamata (anche se l'applicazione era già un proprietario della chiamata). Questo parametro usa una delle costanti LINECALLPRIVILEGE_ seguenti.
Valore restituito
Nessun valore restituito.
Commenti
Questo messaggio viene inviato a qualsiasi applicazione con un handle per la chiamata. Il messaggio LINE_CALLSTATE notifica anche alle applicazioni che monitorano le chiamate su una riga sull'esistenza e sullo stato delle chiamate in uscita stabilite da altre applicazioni o manualmente dall'utente ,ad esempio in un dispositivo telefonico collegato. Lo stato della chiamata di tali chiamate riflette lo stato effettivo della chiamata , che non offre. Esaminando lo stato della chiamata, l'applicazione può determinare se la chiamata è una chiamata in ingresso che deve essere risposta o meno.
Un messaggio LINE_CALLSTATE con uno stato di chiamata sconosciuto può essere inviato a un'applicazione di monitoraggio in seguito a una rigaMakeCall, lineForward, lineUnpark, lineSetupTransfer, linePickup, lineSetupConference o linePrepareAddToConference richiesta da un'altra applicazione. Allo stesso tempo, l'applicazione che richiede viene inviata una LINE_REPLY (esito positivo) per l'operazione richiesta, tutte le applicazioni di monitoraggio nella riga vengono inviate il messaggio LINE_CALLSTATE (sconosciuto). Un messaggio LINE_CALLSTATE che indica lo stato di chiamata "reale" della chiamata appena generata viene inviato (usando le informazioni fornite dal provider di servizi) alle applicazioni di richiesta e monitoraggio poco dopo.
Un messaggio LINE_CALLSTATE (sconosciuto) viene inviato alle applicazioni di monitoraggio solo se lineCompleteTransfer causa la risoluzione delle chiamate in una conferenza a tre vie.
Per la compatibilità con le versioni precedenti, le applicazioni precedenti non prevedono alcun valore specifico in dwParam2 di un messaggio di LINECALLSTATE_CONFERENCED. TAPI passa quindi la chiamata padre hConfCall in dwParam2 indipendentemente dalla versione API dell'applicazione che riceve il messaggio. Nel caso di una conferenza telefonica avviata dal provider di servizi, l'applicazione precedente non è consapevole che la chiamata padre è diventata una chiamata a conferenza, a meno che non si verifichi spontaneamente l'esame di altre informazioni(ad esempio, chiamare lineGetConfRelatedCalls).
Impossibile disabilitare questo messaggio.
Requisiti
| Requisito | Valore |
|---|---|
| Versione TAPI |
Richiede TAPI 2.0 o versione successiva |
| Intestazione |
|