セッションを開始する

通信セッションを開始するためにアプリケーションが提供する主な情報は、 アドレス タイプ、 メディア タイプ、および宛先 アドレス です。

宛先アドレスでは、ユーザーが入力した情報を特定のアドレス タイプに適した形式に変換するために、アドレス変換 が必要になる場合があります。 たとえば、電子アドレス帳に 標準 形式で保存されていた電話番号は、 ダイヤル可能な 形式に変換する必要があります。

サービス プロバイダーによってサポートされている場合、一部のセッションでは特別なセットアップ パラメータが必要になることがあります。 たとえば、ISDN TSP はユーザー間情報を送信できますが、一部の MSP ではメディア ストリームの方向に関する情報が必要です。 セッションに関して設定または取得される可能性のあるデータを確認するには、 セッション情報を参照してください。

セッションが開始されると、TAPI は初期化中に設定されたイベント通知メカニズムを使用して、通話の進行状況をアプリケーションに通知します。

TAPI 2.x: アプリケーションは、 lineMakeCall 関数を使用してセッションを開始します。 lineTranslateAddress 関数は、必要に応じてアドレス変換を実行するために使用されます。

コールセットアップパラメータは LINECALLPARAMS データ構造に保存され、この構造へのポインタは lineMakeCall のパラメータとして使用されます。 LINECALLPARAMS 構造が lineMakeCall に提供されていない場合は、デフォルト値のセットを使用してデフォルトの POTS 音声グレードのコールが要求されます。

セッションが正常に確立されると、 所有者権限 を持つコール ハンドルがアプリケーションに返され、TAPI はコールの進行状況に関する情報を含む LINE_CALLSTATE メッセージをアプリケーションに送信します。 アプリケーションは通常、これらのメッセージを使用してユーザーにステータス レポートを表示します。

TAPI 3.x: アプリケーションは、必要なアドレス タイプとメディア タイプを処理できるアドレスに対して ITAddress::CreateCall メソッドを呼び出すことによって、通信セッションを開始します。 アドレスが ITTerminalSupport インターフェイスを公開している場合、端末はコール オブジェクトのメディア ストリーム上で選択されます。 このプロセスの図解については、 電話をかける のコード例を参照してください。

通話設定パラメータは、 ITCallInfo インターフェイスによって公開されるメソッドを使用して保存または変更できます。

セッションが正常にセットアップされると、TAPI は、さらなるセッション操作に使用できる ITBasicCallControl インターフェイス ポインターを返すか、追加のセッション情報を取得するために使用できる ITCallInfo インターフェイス ポインターを取得します。 ITCallStateEvent インターフェイスは TAPI コール状態イベントを処理します。

Note

TAPI は FAX 送信には使用しないでください。 代わりに、MAPI (Microsoft Messaging API) を通じて利用できる関数を使用してください。

 

アドレス翻訳

エンドユーザーまたはサーバー アプリケーションは、特定のサービス プロバイダーのニーズと互換性のない形式でアドレスを保存する場合があります。 たとえば、電話番号は電子アドレス帳に 標準形式 で保存されますが、電話番号を扱うほとんどのサービス プロバイダーでは ダイヤル可能な形式 が必要です。

TAPI は、アプリケーションが TSP に正しいアドレス タイプを提示するのを支援するアドレス変換操作を提供します。 サービス プロバイダーは、TAPI に対してサポートするアドレス タイプを指定します。アドレス変換の形式を含める必要はありません。

TAPI 2.x: lineTranslateAddressを参照してください。

TAPI 3: ITAddressTranslation, ITAddressTranslationInfoを参照してください。

通行料金表

北米の一部の地域では、市内の市外局番への電話はすべて市内通話となります。 他の地域では、市内局番への一部の通話は長距離通話となり、ダイヤルする前にプレフィックス「1」を付ける必要があります。 住所の最初の 3 桁 (プレフィックス) によって、市内局番内の通話が有料通話かどうかが決まります。

市外局番リスト は、市内局番内のプレフィックスのリストであり、そのアドレスは長距離アドレスとしてダイヤルする必要があり、長距離料金が課せられます。

通話料金リストは、サービス プロバイダーや、電話ネットワークにアクセスしないアプリケーションには関係ありません。

TAPI 2.x: lineTranslateAddress (LINETRANSLATEOUTPUT 構造体の LINETRANSLATERESULT_INTOLLLIST ビットおよび LINETRANSLATERESULT_NOTINTOLLLIST ビット)、lineSetTollList を参照してください。

TAPI 3:ITAddressTranslation::TranslateAddress、ITAddressTranslationInfo::get_TranslationResultsを参照してください。