Metodo ITLegacyCallMediaControl2::D etectTonesByCollection (tapi3if.h)
Il metodo DetectTonesByCollection 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 visual basic e di scripting. Le applicazioni C/C++ devono usare invece il metodo DetectTones .
Sintassi
HRESULT DetectTonesByCollection(
[in] ITCollection2 *pDetectToneCollection
);
Parametri
[in] pDetectToneCollection
Puntatore a un'interfaccia ITCollection2 contenente una raccolta di puntatori dell'interfaccia ITDetectTone che rappresentano i toni da monitorare. Ogni tono nell'elenco ha un campo tag definito dall'applicazione utilizzato per identificare i singoli toni quando il rilevamento dei toni viene segnalato da un evento TE_TONEEVENT . Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pDetectToneCollection non è un puntatore valido. |
|
Memoria insufficiente per allocare il buffer dei toni. |
|
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 DetectTonesByCollection e specificare una raccolta vuota. Per modificare l'elenco di toni da monitorare, chiamare questo metodo e specificare una nuova raccolta di toni.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |