LINE_GATHERDIGITS Nachricht
Die TAPI-LINE_GATHERDIGITS Nachricht wird gesendet, wenn die aktuelle gepufferte Anforderung zum Sammeln von Ziffern beendet oder abgebrochen wurde. Der Ziffernpuffer kann untersucht werden, nachdem diese Nachricht von der Anwendung empfangen wurde.
Parameter
-
hDevice
-
Ein Handle für den Aufruf.
-
dwCallbackInstance
-
Der Rückruf instance beim Öffnen der Zeile angegeben.
-
dwParam1
-
Der Grund, warum die Ziffernsammlung beendet wurde. Dieser Parameter muss nur eine der LINEGATHERTERM_ Konstanten sein.
-
dwParam2
-
Nicht verwendet.
-
dwParam3
-
Die "Tick-Anzahl" (Anzahl der Millisekunden seit Dem Start von Windows), mit der die Ziffernsammlung abgeschlossen wurde. Für TAPI-Versionen vor 2.0 wird dieser Parameter nicht verwendet.
Rückgabewert
Kein Rückgabewert.
Bemerkungen
Die LINE_GATHERDIGITS Nachricht wird nur an die Anwendung gesendet, die die Ziffernsammlung beim Aufruf mithilfe von lineGatherDigits initiiert hat.
Wenn die lineGatherDigits-Funktion verwendet wird, um eine vorherige Anforderung zum Sammeln von Ziffern abzubrechen, sendet TAPI eine LINE_GATHERDIGITS Nachricht mit dwParam1 , die auf LINEGATHERTERM_CANCEL festgelegt ist, an die Anwendung, die angibt, 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, auf dem die Anwendung ausgeführt wird, generiert wurde, ist er nur für den Vergleich mit anderen ähnlichen Zeitstempelmeldungen nützlich, die auf demselben Leitungsgerät (LINE_GENERATE, LINE_MONITORDIGITS, LINE_MONITORMEDIA, LINE_MONITORTONE) generiert wurden, um deren relatives Timing (Trennung zwischen Ereignissen) zu bestimmen. Die Anzahl der Teilstriche kann sich nach etwa 49,7 Tagen "umschließen"; Anwendungen müssen dies bei der Durchführung 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, der das Ereignis generiert, am nächsten liegt, damit 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 zum Schreiben zur Verfügung halten, bis eine LINE_REPLY oder LINE_GATHERDIGITS Nachricht empfangen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher. |
| Header |
|