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
Tapi.h

Siehe auch

LINE_GATHERDIGITS

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE