LINE_GATHERDIGITS訊息

TAPI LINE_GATHERDIGITS 訊息會在目前的緩衝數位收集要求終止或取消時傳送。 在應用程式收到此訊息之後，即可檢查數位緩衝區。

參數

hDevice

呼叫的控制碼。

dwCallbackInstance

開啟行時提供的回呼實例。

dwParam1

數位收集終止的原因。 此參數必須是其中一個且只有一個 LINEGATHERTERM_常數。

dwParam2

未使用的。

dwParam3

「刻度計數」 (從 Windows 開始) 完成數位收集之後的毫秒數。 若為 2.0 之前的 TAPI 版本，則未使用此參數。

傳回值

沒有傳回值。

備註

LINE_GATHERDIGITS訊息只會傳送至使用lineGatherDigits在呼叫上起始數位收集的應用程式。

如果 lineGatherDigits 函式用來取消先前收集數位的要求，TAPI 會傳送 LINE_GATHERDIGITS 訊息，並將 dwParam1 設定為LINEGATHERTERM_CANCEL至應用程式，指出原始指定的緩衝區包含收集到取消的數位。

因為dwParam3指定的時間戳記可能已經產生于應用程式執行所在電腦以外的電腦上，所以只有在相同線路裝置上產生的其他類似時間戳記訊息 ( LINE_GENERATE、LINE_MONITORDIGITS、LINE_MONITORMEDIA、LINE_MONITORTONE) ，才能判斷其相對時間 (分隔事件) 。 刻度計數可以在大約 49.7 天后「包裝」;應用程式在執行計算時必須考慮這一點。

例如，如果服務提供者不會產生時間戳記 (，如果使用舊版 TAPI) 建立，則 TAPI 會在產生事件之服務提供者最接近的點提供時間戳記，讓合成時間戳記盡可能精確。

注意

當應用程式叫用任何將資料寫回應用程式記憶體的非同步作業時，應用程式必須保留該記憶體可供寫入，直到收到 LINE_REPLY 或 LINE_GATHERDIGITS 訊息為止。

規格需求

需求	值
TAPI 版本	需要 TAPI 2.0 或更新版本
標頭	Tapi.h

另請參閱

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits