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
S_OK
Il metodo è riuscito.
E_POINTER
Il parametro pDetectToneCollection non è un puntatore valido.
E_OUTOFMEMORY
Memoria insufficiente per allocare il buffer dei toni.
TAPI_E_INVALCALLSTATE
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

Vedi anche

ITCollection2

ITDetectTone

ITLegacyCallMediaControl2