ITLegacyCallMediaControl2::D etectTonesByCollection-Methode (tapi3if.h)
Die DetectTonesByCollection-Methode aktiviert und deaktiviert die Erkennung von Inbandtönen für den Aufruf. Jedes Mal, wenn ein angegebener Ton erkannt wird, wird eine Nachricht an die Anwendung gesendet.
Diese Methode ist für Visual Basic- und Skriptanwendungen vorgesehen. C/C++-Anwendungen sollten stattdessen die DetectTones-Methode verwenden.
Syntax
HRESULT DetectTonesByCollection(
[in] ITCollection2 *pDetectToneCollection
);
Parameter
[in] pDetectToneCollection
Zeiger auf eine ITCollection2-Schnittstelle , die eine Sammlung von ITDetectTone-Schnittstellenzeigern enthält, die die zu überwachenden Töne darstellen. Jeder Ton in der Liste verfügt über ein anwendungsdefiniertes Tagfeld, das verwendet wird, um die einzelnen Töne zu identifizieren, wenn die Tonerkennung von einem TE_TONEEVENT-Ereignis gemeldet wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der pDetectToneCollection-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Puffer für Töne zuzuordnen. |
|
Der Aufruf muss sich im Zustand verbunden befinden. |
Hinweise
Diese Methode wird in eine TAPI 2 übersetzt. xlineMonitorTones-Aufruf .
Um die laufende Tonüberwachung abzubrechen, rufen Sie die DetectTonesByCollection-Methode auf, und geben Sie eine leere Auflistung an. Um die Liste der zu überwachenden Töne zu ändern, rufen Sie diese Methode auf, und geben Sie eine neue Tonsammlung an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |