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 以降が必要です
ヘッダー	Tapi.h

関連項目

LINE_GENERATE

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE

LINE_REPLY

lineGatherDigits