LINE_MONITORTONE メッセージ
TAPI LINE_MONITORTONE メッセージは、トーンが検出されると送信されます。 このメッセージの送信は、 lineMonitorTones 関数を使用して制御されます。
パラメーター
-
hDevice
-
呼び出しのハンドル。
-
dwCallbackInstance
-
呼び出しの行を開くときに指定されたコールバック インスタンス。
-
dwParam1
-
検出されたトーンの LINEMONITORTONE 構造体のアプリケーション固有の dwAppSpecific メンバー。
-
dwParam2
-
未使用。
-
dwParam3
-
トーンが検出された "ティック数" (Windows が起動してからのミリ秒)。 2.0 より前の API バージョンの場合、このパラメーターは使用されません。
戻り値
戻り値はありません。
注釈
LINE_MONITORTONE メッセージは、トーンの監視を要求したアプリケーションにのみ送信されます。
このタイムスタンプは、アプリケーションが実行されているコンピューター以外のコンピューターで生成されている可能性があるため、相対的なタイミング (イベント間の分離) を決定するために、同じ行デバイス ( LINE_GATHERDIGITS、 LINE_GENERATE、 LINE_MONITORDIGITS、 LINE_MONITORTONE) で生成される他の同様にタイムスタンプ付きメッセージとの比較にのみ役立ちます。 ティック数は、約 49.7 日後に "ラップアラウンド" できます。アプリケーションでは、計算を実行するときにこれを考慮する必要があります。
サービス プロバイダーがタイムスタンプを生成しない場合 (たとえば、以前のバージョンの TAPI を使用して作成された場合)、TAPI は、合成されたタイムスタンプが可能な限り正確になるように、イベントを生成するサービス プロバイダーに最も近い時点でタイムスタンプを提供します。
要件
| 要件 | 値 |
|---|---|
| TAPI バージョン |
TAPI 2.0 以降が必要です |
| Header |
|