ITTAPI

ITTAPI インターフェイスは、TAPI オブジェクトの基本インターフェイスです。TAPI オブジェクトは CoCreateInstance によって作成されます。CoCreateInstance の詳細については、COM のドキュメントを参照してください。その他のすべての TAPI 3 オブジェクトは、TAPI 3 自体によって作成されます。

Initialize メソッドは TAPI を初期化します。このメソッドは、他の TAPI 3 メソッドを呼び出す前に呼び出す必要があります。アプリケーションは、TAPI セッションを終了するときに Shutdown メソッドを呼び出す必要があります。

このメソッドは次の値のいずれかを返します。

Shutdown メソッドは TAPI セッションをシャットダウンします。

このメソッドは次の値のいずれかを返します。

Shutdown が失敗する理由の 1 つは、事前に Initialize が正常に呼び出されていなかった場合です。

get_Addresses メソッドは、現在利用可能なアドレスのコレクションを作成します。Visual Basic で記述されたものなど、オートメーションクライアントアプリケーション向けに提供されています。C および C++ アプリケーションは EnumerateAddresses メソッドを使用する必要があります。

このメソッドは次の値のいずれかを返します。

TAPI は、ITTAPI::get_Addesses によって返される ITAddress インターフェイスに対して Addref メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために、 ITAddress インターフェイスに対して Release を呼び出す必要があります。

EnumerateAddresses メソッドは、現在利用可能なアドレスを列挙します。C および C++ アプリケーション向けに提供されています。Visual Basic で記述されたものなど、オートメーションクライアントアプリケーションは get_Addresses メソッドを使用する必要があります。

このメソッドは次の値のいずれかを返します。

アプリケーションは通常、この列挙を使用して各アドレスの機能を確認し、現在の目的に有用なものを判断します。

想定していたアドレスが見つからない場合は、適切なサービスプロバイダーがインストールされていないか、正しく動作していない可能性があります。

TAPI は、ITTAPI::EnumerateAddresses によって返される IEnumAddress インターフェイスに対して Addref メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために、 IEnumAddress インターフェイスに対して Release メソッドを呼び出す必要があります。

TAPI セッション中にアドレスが作成または削除された場合、アプリケーションは ITTAPIEventNotification インターフェイスを通じて通知されます。プラグアンドプレイデバイスのインストールなどによってアドレスが作成された場合、 ITTAPIEventNotification::Event は TAPIOBJECT_EVENT 列挙型の TE_ADDRESSCREATE メンバーを返します。アドレスが削除された場合、ITTAPIEventNotification::Event は TE_ADDRESSREMOVE を返します。これらのイベントの後に EnumerateAddresses を呼び出すと、現在のアドレスが反映されます。

RegisterCallNotifications メソッドは、アプリケーションが受信する新しい通話通知を設定します。アプリケーションは、処理できるメディアタイプを示し、要求する権限を指定して、アドレスごとにこのメソッドを呼び出す必要があります。

このメソッドは次の値のいずれかを返します。

このメソッドが 1 つのアドレスに対して複数回呼び出された場合、アプリケーションが既に監視している通話がそのアプリケーションにハンドオフされると、コールハブからの参加者通話に関する情報が混乱を招くことがあります。

RegisterCallNotifications メソッドは、指定されたメディアタイプの通話の監視、またはその所有権の受け取りに関心があるものとして、アプリケーションを登録します。これらの通話権限は fMonitor および fOwner パラメーターで設定されます。 アプリケーションは、複数のメディアタイプを処理するために複数のフラグを指定できます。複数のアプリケーションが同じアドレスおよびメディアタイプに対して登録すると、競合が発生する可能性があります。これらの競合は、ユーザーがアプリケーションに相対的な優先順位を割り当てる優先順位方式によって解決されます。ユーザーは ITTAPI::SetApplicationPriority 関数を呼び出すことで、アプリケーションの優先順位を設定できます。特定のメディアタイプに対して最も優先順位の高いアプリケーションのみが、そのメディアタイプの通話の所有権を(要求せずに)受け取ります。所有権は、着信通話が最初に到着したとき、または通話がハンドオフされたときに受け取ることができます。通話の所有権を別のアプリケーションにハンドオフするには、ITBasicCallControl::HandoffDirect および ITBasicCallControl::HandoffIndirect 関数が呼び出されます。ユーザーがアプリケーションに優先順位を割り当てず、複数のアプリケーションが同じ回線デバイスを開いた場合、既定では、最初に RegisterCallNotifications を呼び出したアプリケーションが最も高い優先順位を持ちます。

UnregisterNotifications メソッドは、ITTAPI::RegisterCallNotifications を使用して行われた着信通話通知の登録をすべて削除します。

このメソッドは次の値のいずれかを返します。

get_CallHubs メソッドは、現在利用可能なコールハブのコレクションを作成します。Visual Basic で記述されたものなど、オートメーションクライアントアプリケーション向けに提供されています。C および C++ アプリケーションは EnumerateCallHubs メソッドを使用する必要があります。

このメソッドは次の値のいずれかを返します。

TAPI は、ITTAPI::get_CallHubs によって返される ITCallHub インターフェイスに対して Addref メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために、 ITCallHub インターフェイスに対して Release を呼び出す必要があります。

EnumerateCallHubs メソッドは、現在利用可能なコールハブを列挙します。C および C++ アプリケーション向けに提供されています。Visual Basic で記述されたものなど、オートメーションクライアントアプリケーションは get_Callhubs メソッドを使用する必要があります。

このメソッドは次の値のいずれかを返します。

TAPI は、ITTAPI::EnumerateCallHubs によって返される IEnumCallHub インターフェイスに対して Addref メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために、 IEnumCallHub インターフェイスに対して Release を呼び出す必要があります。

SetCallHubTracking メソッドは、CallHub トラッキングを有効または無効にします。

このメソッドは次の値のいずれかを返します。

ITTAPI インターフェイスの EnumeratePrivateTAPIObjects メソッドは実装されておらず、E_NOTIMPL を返します。

このメソッドは値を返しません。

ITTAPI インターフェイスの get_PrivateTAPIObjects メソッドは実装されておらず、E_NOTIMPL を返します。

このメソッドは値を返しません。

RegisterRequestRecipient メソッドは、アシステッドテレフォニー要求を処理する適切なものとして、アプリケーションインスタンスを登録します。

このメソッドは次の値のいずれかを返します。

SetAssistedTelephonyPriority メソッドは、アシステッドテレフォニー要求を処理するアプリケーションの優先順位を設定します。

このメソッドは次の値のいずれかを返します。

アプリケーションは、pAppFilename パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにそのメモリを解放するために SysFreeString を使用する必要があります。

SetApplicationPriority メソッドを使用すると、アプリケーションは特定のメディアタイプまたはアシステッドテレフォニー要求モードのハンドオフ優先順位リスト内で自身の優先順位を設定したり、優先順位リストから自身を削除したりできます。

このメソッドは次の値のいずれかを返します。

アプリケーションは、pAppFilename パラメーターのメモリを割り当てるために SysAllocString を使用し、変数が不要になったときにそのメモリを解放するために SysFreeString を使用する必要があります。

SetApplicationPriority で設定された優先順位は、システムの再起動や tapisrv の再起動をまたいで保持されます。ITTAPI::RegisterCallNotifications 関数は、通話の優先順位を指定せずに回線を開きます。既定では、最も優先順位の高いアプリケーションは、最初に ITTAPI::RegisterCallNotifications を呼び出したものになります。

put_EventFilter メソッドは、イベントフィルターマスクを設定します。このマスクは、TAPI_EVENT 列挙型のメンバーを OR 演算で連結したものです。

このメソッドは次の値のいずれかを返します。

get_EventFilter メソッドは、現在のイベントフィルターマスクを取得します。このマスクは、TAPI_EVENT 列挙型のメンバーを OR 演算で連結したものです。

このメソッドは次の値のいずれかを返します。