Nachricht LINE_GENERATE
Die Nachricht TAPI LINE\_GENERATE wird gesendet, um die Anwendung darüber zu benachrichtigen, dass die aktuelle Ziffer oder die aktuelle Tongenerierung beendet wurde. Nur eine solche Generierungsanforderung kann in einem bestimmten Anruf zu einem gegebenen Zeitpunkt in Bearbeitung sein. Diese Nachricht wird auch gesendet, wenn die Ziffern- oder Tongenerierung abgebrochen wird.
Parameter
-
hDevice
-
Ein Handle zum Aufruf.
-
dwCallbackInstance
-
Die beim Öffnen der Zeile bereitgestellte Rückrufinstanz.
-
dwParam1
-
Der Grund, warum die Ziffern- oder Tongenerierung beendet wurde. Dieser Parameter muss genau eine der LINEGENERATETERM_-Konstanten enthalten.
-
dwParam2
-
Nicht verwendet.
-
dwParam3
-
Die „CPU-Zyklusanzahl“ (Anzahl der Millisekunden seit dem Start von Windows), bei der die Ziffern- oder Tongenerierung abgeschlossen wurde. Bei API-Versionen vor 2.0 wird dieser Parameter nicht verwendet.
Rückgabewert
Kein Rückgabewert.
Hinweise
Die Nachricht LINE_GENERATE wird nur an die Anwendung gesendet, die die Ziffern- oder Tongenerierung angefordert hat.
Weil der durch dwParam3 angegebene Zeitstempel möglicherweise auf einem anderen Computer als dem Computer, auf dem die Anwendung ausgeführt wird, generiert wurde, ist er nur für den Vergleich mit anderen ähnlich Nachrichten mit Zeitstempel nützlich, die auf demselben Line-Device generiert wurden ( LINE_GATHERDIGITS, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE), um deren relatives Timing (Abstand zwischen Ereignissen) zu bestimmen. Die CPU-Zyklusanzahl kann nach ungefähr 49,7 Tagen „umbrochen werden“; Anwendungen müssen dies beim Ausführen von Berechnungen berücksichtigen.
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, der dem Dienstanbieter, der das Ereignis erzeugt, am nächsten liegt, bereit, sodass der synthetisierte Zeitstempel so genau wie möglich ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher |
| Header |
|