LINE_GATHERDIGITS メッセージ
TAPI LINE_GATHERDIGITS メッセージは、現在のバッファー内の桁収集要求が終了したか取り消されたときに送信されます。 このメッセージがアプリケーションによって受信された後で、数字バッファーを調べることができます。
パラメーター
-
hDevice
-
呼び出しのハンドル。
-
dwCallbackInstance
-
行を開くときに指定されたコールバック インスタンス。
-
dwParam1
-
桁収集が終了した理由。 このパラメーターは、 LINEGATHERTERM_定数の 1 つだけである必要があります。
-
dwParam2
-
未使用。
-
dwParam3
-
数字の収集が完了した "ティック数" (Windows が開始されてからのミリ秒)。 2.0 より前の TAPI バージョンの場合、このパラメーターは使用されません。
戻り値
戻り値はありません。
解説
LINE_GATHERDIGITS メッセージは、lineGatherDigits を使用して呼び出しで桁収集を開始したアプリケーションにのみ送信されます。
lineGatherDigits 関数を使用して前の要求を取り消して数字を収集する場合、TAPI は dwParam1 を LINEGATHERTERM_CANCELに設定したLINE_GATHERDIGITS メッセージをアプリケーションに送信し、元に指定されたバッファーに取り消しまでの数字が含まれていることを示します。
dwParam3 によって指定されたタイムスタンプは、アプリケーションが実行されているコンピューター以外のコンピューターで生成されている可能性があるため、相対的なタイミング (イベント間の分離) を決定するために、同じ行デバイス (LINE_GENERATE、LINE_MONITORDIGITS、LINE_MONITORMEDIA、LINE_MONITORTONE) で生成された他の同様にタイムスタンプ付きメッセージとの比較にのみ役立ちます。 ティック数は、約 49.7 日後に "ラップアラウンド" できます。アプリケーションでは、計算を実行するときにこれを考慮する必要があります。
サービス プロバイダーがタイムスタンプを生成しない場合 (たとえば、以前のバージョンの TAPI を使用して作成された場合)、TAPI は、合成されたタイムスタンプが可能な限り正確になるように、イベントを生成するサービス プロバイダーに最も近い時点でタイムスタンプを提供します。
注意
アプリケーションがアプリケーション メモリにデータを書き戻す非同期操作を呼び出す場合、アプリケーションは、 LINE_REPLY または LINE_GATHERDIGITS メッセージが受信されるまで、そのメモリを書き込み可能な状態に保つ必要があります。
必要条件
| 要件 | 値 |
|---|---|
| TAPI バージョン |
TAPI 2.0 以降が必要です |
| ヘッダー |
|