Metodo ITLegacyCallMediaControl2::D etectTones (tapi3if.h)
Il metodo DetectTones 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.
Questo metodo è destinato alle applicazioni C/C++. Le applicazioni visual Basic e scripting devono usare invece il metodo DetectTonesByCollection .
Sintassi
HRESULT DetectTones(
[in] TAPI_DETECTTONE *pToneList,
[in] long lNumTones
);
Parametri
[in] pToneList
Puntatore a una matrice di TAPI_DETECTTONE che specifica i toni da rilevare. Ogni tono nella matrice ha un campo tag definito dall'applicazione utilizzato per identificare i singoli toni nell'elenco quando viene segnalato un evento di rilevamento dei toni di tipo TE_TONEEVENT . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
[in] lNumTones
Numero di voci nella matrice specificata dal parametro pToneList . Questo parametro viene ignorato se pToneList è NULL.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pToneList non è un puntatore valido. |
|
La chiamata deve trovarsi nello stato connesso . |
Commenti
Questo metodo si traduce in un TAPI 2. Chiamata xlineMonitorTones .
Per annullare il monitoraggio del tono in corso, chiamare il metodo DetectTones e specificare un parametro pToneListNULL. Per modificare l'elenco di toni da monitorare, chiamare questo metodo e specificare un nuovo elenco di toni.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |