LINE_GENERATE メッセージ

TAPI LINE_GENERATE メッセージは、現在のディジットまたはトーンの生成が終了したことをアプリケーションに通知するために送信されます。 このような生成要求は、特定の呼び出しでは、いつでも 1 つだけ進行中にすることができます。 このメッセージは、ディジットまたはトーンの生成が取り消されたときにも送信されます。

パラメーター

hDevice

呼び出しへのハンドル。

dwCallbackInstance

行を開くときに指定されたコールバック インスタンス。

dwParam1

ディジットまたはトーンの生成が終了した理由。 このパラメーターは LINEGENERATETERM_ 定数の唯一のものである必要があります。

dwParam2

未使用。

dwParam3

ディジットまたはトーンの生成が完了した "ティック数" (Windows が開始されてからのミリ秒)。 2.0 より前のバージョンの API の場合、このパラメーターは使用されません。

戻り値

戻り値はありません。

解説

LINE_GENERATE メッセージは、ディジットまたはトーンの生成を要求したアプリケーションにのみ送信されます。

dwParam3 で指定されたタイムスタンプは、アプリケーションが実行されているコンピューター以外のコンピューターで生成されている可能性があるため、相対的なタイミング (イベント間の間隔) を決定するために、同じライン デバイス (LINE_GATHERDIGITS、LINE_MONITORDIGITS、LINE_MONITORMEDIA、LINE_MONITORTONE) で生成された他の同様のタイムスタンプ付きメッセージとの比較にのみ役立ちます。 ティック数は、約 49.7 日後に "折り返す" ことができます。アプリケーションでの計算の際には、アプリケーションがこれを考慮する必要があります。

サービス プロバイダーによってタイムスタンプが生成されない場合は (たとえば、以前のバージョンの TAPI を使用して作成された場合は)、合成されたタイムスタンプが可能な限り正確になるように、イベントを生成するサービス プロバイダーに最も近い時点でタイムスタンプが TAPI によって提供されます。

要件

要件	値
TAPI バージョン	TAPI 2.0 以降が必要です
ヘッダー	Tapi.h

関連項目

LINE_GATHERDIGITS

LINE_MONITORDIGITS

LINE_MONITORMEDIA

LINE_MONITORTONE