ITLegacyCallMediaControl2::D etectTones-Methode (tapi3if.h)
Die DetectTones-Methode aktiviert und deaktiviert die Erkennung von Inbandtönen auf dem Aufruf. Jedes Mal, wenn ein angegebener Ton erkannt wird, wird eine Nachricht an die Anwendung gesendet.
Diese Methode ist für C/C++-Anwendungen vorgesehen. Visual Basic- und Skriptanwendungen sollten stattdessen die DetectTonesByCollection-Methode verwenden.
Syntax
HRESULT DetectTones(
[in] TAPI_DETECTTONE *pToneList,
[in] long lNumTones
);
Parameter
[in] pToneList
Zeiger auf ein TAPI_DETECTTONE Array, das die zu erkennenden Töne angibt. Jeder Ton im Array verfügt über ein anwendungsdefiniertes Tagfeld, das verwendet wird, um die einzelnen Töne in der Liste zu identifizieren, wenn ein Tonerkennungsereignis vom Typ TE_TONEEVENT gemeldet wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
[in] lNumTones
Die Anzahl der Einträge in dem Array, das durch den pToneList-Parameter angegeben wird. Dieser Parameter wird ignoriert, wenn pToneListNULL ist.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der pToneList-Parameter ist kein gültiger Zeiger. |
|
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 DetectTones-Methode auf, und geben Sie einen pToneList-Parameter NULLan . Um die Liste der zu überwachenden Töne zu ändern, rufen Sie diese Methode auf, und geben Sie eine neue Tonliste an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |