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

Vedi anche

LINEMONITORTONE

Funzioni di servizio linea supplementari

Panoramica di riferimento su TAPI 2.2