LINE_MONITORTONE Nachricht
Die TAPI LINE_MONITORTONE Nachricht wird gesendet, wenn ein Ton erkannt wird. Das Senden dieser Nachricht wird mit der funktion lineMonitorTones gesteuert.
Parameter
-
hGeräte
-
Ein Handle für den Anruf.
-
dwCallbackInstance
-
Der Rückruf instance beim Öffnen der Anrufzeile angegeben.
-
dwParam1
-
Das anwendungsspezifische dwAppSpecific-Element der LINEMONITORTONE-Struktur für den erkannten Ton.
-
dwParam2
-
Nicht verwendet.
-
dwParam3
-
Die "Tickanzahl" (Anzahl der Millisekunden seit Windows-Start), bei der der Ton erkannt wurde. Für API-Versionen vor 2.0 wird dieser Parameter nicht verwendet.
Rückgabewert
Kein Rückgabewert.
Bemerkungen
Die LINE_MONITORTONE Nachricht wird nur an die Anwendung gesendet, die angefordert hat, dass der Ton überwacht werden soll.
Da dieser Zeitstempel möglicherweise auf einem anderen Computer als dem Computer generiert wurde, auf dem die Anwendung ausgeführt wird, ist er nur für den Vergleich mit anderen ähnlich zeitstempelten Nachrichten nützlich, die auf demselben Zeilengerät ( LINE_GATHERDIGITS, LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORTONE) generiert wurden, um deren relatives Timing (Trennung zwischen Ereignissen) zu bestimmen. Die Zeckenanzahl kann sich nach etwa 49,7 Tagen "umschließen"; Dies muss von Anwendungen bei der Berechnung berücksichtigt werden.
Wenn der Dienstanbieter den Zeitstempel nicht generiert (z. B. wenn er mit einer früheren Version von TAPI erstellt wurde), stellt TAPI einen Zeitstempel an dem Punkt bereit, an dem der Dienstanbieter das Ereignis generiert, so dass der synthetisierte Zeitstempel so genau wie möglich ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|