イベント通知

イベント通知は、アプリケーションが TAPI とサービス プロバイダーから情報を取得する主な手段です。 この情報は、アプリケーションによって開始された非同期操作の状態であるか、新しい着信呼び出しの通知など、アプリケーションの外部で開始されたプロセスに関する可能性があります。

TAPI 2.x: アプリケーションは、非表示ウィンドウ、イベント ハンドル、または完了ポートの 3 つの方法のいずれかで通知を処理します。 これらの通知メカニズムの詳細については、 lineInitializeEx の「解説」セクションを参照してください。 アプリケーションは、lineInitializeEx を呼び出す前に LINEINITIALIZEEXPARAMS 構造体の dwOptions メンバーを設定することで、メカニズムを指定します。

lineSetStatusMessages 関数を使用すると、アプリケーションは、指定した行またはそのアドレスの状態の変更に関連するイベントに対して受信する通知メッセージを指定できます。

TAPI 3.x: アプリケーションは、COM 標準 の接続可能オブジェクトを使用して一般的な通知を処理します。 ITTAPIEventNotification は TAPI のコンテナー オブジェクトに登録する必要がある発信インターフェイスであり、 ITTAPIEventNotification::Event は、アプリケーションの応答を決定するための TAPI 呼び出しメソッドです。 ITTAPI::p ut_EventFilter メソッドは、アプリケーションにとって関心のあるイベントを TAPI に通知します。 イベント フィルターが入力されていない場合、アプリケーションはイベントの通知を受け取りません。 ITTAPI::RegisterCallNotifications メソッドは、アプリケーションが受信セッションを処理するメディアの種類とアドレスを TAPI に通知します。 TAPI 3 イベント処理の詳細については、「イベントの概要」または 「イベント の 登録」 のコード例を参照してください。

テレフォニー サービス プロバイダーは、 TSPI_lineSetDefaultMediaDetection と TSPI_lineSetStatusMessagesを実装します。 TAPI は、これらの関数を呼び出して、アプリケーションによって要求されたすべての行、アドレス、およびメディアの種類のイベントのセットを示します。