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 |
|