LINE _ GATHERDIGITS-Nachricht

Die TAPI LINE _ GATHERDIGITS-Nachricht wird gesendet, wenn die aktuelle Anforderung zur Erfassung gepufferter Ziffern beendet oder abgebrochen wurde. Der Ziffernpuffer kann überprüft werden, nachdem diese Nachricht von der Anwendung empfangen wurde.

            

Parameter

hDevice

Ein Handle für den Aufruf.

dwCallbackInstance

Die Rückrufinstanz, die beim Öffnen der Zeile angegeben wird.

dwParam1

Der Grund, warum die Ziffernsammlung beendet wurde. Dieser Parameter darf nur eine der LINEGATHERTERM-Konstanten _ sein.

dwParam2

Nicht verwendet.

dwParam3

Die "Tickanzahl" (Anzahl von Millisekunden seit dem Start Windows), mit der die Ziffernsammlung abgeschlossen wurde. Bei TAPI-Versionen vor 2.0 wird dieser Parameter nicht verwendet.

Rückgabewert

Kein Rückgabewert.

Hinweise

Die LINE _ GATHERDIGITS-Nachricht wird nur an die Anwendung gesendet, die die Ziffernsammlung für den Aufruf mithilfe von lineGatherDigitsinitiiert hat.

Wenn die funktion lineGatherDigits verwendet wird, um eine vorherige Anforderung zum Erfassen von Ziffern abzubrechen, sendet TAPI eine LINE _ GATHERDIGITS-Nachricht, bei der dwParam1 auf LINEGATHERTERM CANCEL festgelegt ist, _ und gibt an, dass der ursprünglich angegebene Puffer die bis zum Abbruch erfassten Ziffern enthält.

Da der von dwParam3 angegebene 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 ähnlichen Nachrichten mit Zeitstempeln nützlich, die auf demselben Zeilengerät generiert wurden ( LINE _ GENERATE, LINE _ MONITORDIGITS, LINE _ MONITORMEDIA, LINE _ MONITORTONE), um deren relative Zeitsteuerung (Trennung zwischen Ereignissen) zu bestimmen. Die Tickanzahl kann nach ungefähr 49,7 Tagen "umschließen". -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 bereit, der dem Dienstanbieter am nächsten liegt, der das Ereignis generiert, sodass der synthetisierte Zeitstempel so genau wie möglich ist.

Hinweis

Wenn eine Anwendung einen asynchronen Vorgang aufruft, der Daten zurück in den Anwendungsspeicher schreibt, muss die Anwendung diesen Arbeitsspeicher für das Schreiben verfügbar halten, bis eine LINE _ REPLY- oder LINE _ GATHERDIGITS-Nachricht empfangen wird.

Anforderungen

Anforderung Wert
TAPI-Version
Erfordert TAPI 2.0 oder höher
Header
Tapi.h

Siehe auch

LINE _ GENERATE

LINE _ MONITORDIGITS

LINE _ MONITORMEDIA

LINE _ MONITORTONE

_ZEILENANTWORT

lineGatherDigits