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

Siehe auch

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits