funzione lineMonitorTones (tapi.h)
La funzione lineMonitorTones abilita e disabilita il rilevamento dei toni in banda nella chiamata. Ogni volta che viene rilevato un tono specificato, viene inviato un messaggio all'applicazione.
Sintassi
LONG lineMonitorTones(
HCALL hCall,
LPLINEMONITORTONE const lpToneList,
DWORD dwNumEntries
);
Parametri
hCall
Gestire la chiamata sui cui toni del canale vocale devono essere monitorati. Lo stato della chiamata di hCall può essere qualsiasi stato, ad eccezione dell'inattività.
lpToneList
Elenco di toni da monitorare. Questo parametro è di tipo LINEMONITORTONE. Ogni tono in questo elenco include un campo tag definito dall'applicazione utilizzato per identificare i singoli toni nell'elenco per segnalare un rilevamento dei toni. Il monitoraggio tono in corso viene annullato o modificato chiamando questa operazione con NULL per lpToneList o con un altro elenco di toni.
dwNumEntries
Numero di voci in lpToneList. Questo parametro viene ignorato se lpToneList è NULL.
Valore restituito
Restituisce zero se la richiesta ha esito positivo o un numero di errore negativo se si verifica un errore. I valori restituiti possibili sono:
LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_INVALTONE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Commenti
Questa funzione ha esito positivo se il monitoraggio del tono è stato avviato correttamente, non quando il monitoraggio del tono è terminato. Il monitoraggio del tono rimane attivo fino a quando non viene disabilitato in modo esplicito chiamando lineMonitorTones con un altro elenco di toni (o NULL), fino a quando la chiamata passa all'inattività o quando l'applicazione dealloca il relativo handle di chiamata per la chiamata.
Anche se questa funzione può essere richiamata in qualsiasi stato di chiamata, i toni possono in genere essere rilevati solo mentre la chiamata si trova nello stato connesso . Il rilevamento dei toni richiede in genere risorse di calcolo. A seconda del provider di servizi e di altre attività che competono per tali risorse, il numero di toni che possono essere rilevati può variare nel tempo. Inoltre, una quantità equivalente di risorse può essere utilizzata per il monitoraggio di un singolo tono di frequenza triplo rispetto a tre toni di frequenza singola. Se le risorse vengono sovracommesse, viene restituito l'errore LINEERR_RESOURCEUNAVAIL.
La funzione lineMonitorTones viene usata anche per rilevare il silenzio. Il silenzio viene specificato come tono con una frequenza pari a zero.
Il monitoraggio dei toni in una chiamata di conferenza si applica solo all'hConfCall, non alle singole chiamate partecipanti
Se viene restituito il valore di errore LINEERR_INVALPOINTER, il parametro lpToneList specificato non è valido o il valore specificato dal parametro dwNumEntries è troppo grande.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi.h |
| Libreria | Tapi32.lib |
| DLL | Tapi32.dll |