TSPI デバイス クラス
デバイス クラスは、アプリケーションが通話を構成する情報またはデータを送受信する、関連する物理デバイスまたはデバイス ドライバーのグループです。 すべてのデバイス クラスには、 クラス を一意に識別し、クラス内のデバイスを開いて通信するために使用できるプログラミング インターフェイスとコマンドに関する情報を提供するデバイス クラス名があります。
テレフォニー アプリケーション プログラミング インターフェイス (TAPI) は、1 つ以上のデバイス クラスのデバイスを各行または電話デバイスに関連付けます。 これらのデバイスのいずれかにアクセスする場合は、 lineGetID 関数または phoneGetID 関数を使用してデバイスのデバイス識別子を取得します。 デバイス クラス名を指定すると、 関数は、デバイスを開いてアクセスするために必要な特定のポート名、デバイス名、デバイス ハンドル、またはデバイス識別子を返します。 返される情報の形式はデバイス クラスによって異なり、このセクションで説明します。
また、lineConfigDialog 関数と phoneConfigDialog 関数でデバイス クラス名を使用して、ユーザーが特定のデバイスの構成オプションを設定できるようにします。lineGetIcon 関数と phoneGetIcon 関数を使用して、指定されたデバイスを表すアイコンを取得します。および lineGetDevConfig 関数と lineSetDevConfig 関数を使用して、指定されたデバイスの構成オプションを直接取得および設定します。
既定のデバイス クラス名を次に示します。
| デバイス クラス名 | 説明 |
|---|---|
| 通信 | 通信ポート |
| comm/datamodem | 通信ポートを介したモデム |
| comm/datamodem/portname | モデムが接続されているデバイスの名前 |
| wave/in | Wave オーディオ デバイス (入力のみ) |
| wave/out | Wave オーディオ デバイス (出力のみ) |
| wave/in/out | 波オーディオ デバイス、全二重 |
| midi/in | MIDI シーケンサー (入力のみ) |
| midi/out | MIDI シーケンサー (出力のみ) |
| tapi/line | 回線デバイス |
| tapi/phone | 電話デバイス |
| Ndis | ネットワーク デバイス |
| tapi/terminal | ターミナル デバイス |
これらの名前は大文字と小文字を区別しないため、大文字と小文字の任意の組み合わせを使用できます。
特定のシステムでは、追加のデバイス クラスとデバイス クラス名を使用できます。 一般に、デバイスが既定のデバイス クラスのいずれかに属していない場合、製造元は通常、新しいデバイス クラスを定義し、一意のデバイス クラス名を割り当てます。 使用できる追加のデバイス クラスを決定するには、デバイスのドキュメントをチェックする必要があります。 ただし、デバイス クラスとメディアの種類は関連していますが、同じではないことに注意してください。 メディアの種類は、呼び出しに関する情報の形式を記述し、デバイス クラスは、その情報を管理するために使用されるプログラミング インターフェイスを定義します。 そのため、製造元が新しいメディアの種類を定義した場合でも、製造元がモードをサポートするために新しいデバイス クラスを定義する必要があるのは事実ではない可能性があります。
lineSetDevConfig 関数と lineGetDevConfig 関数で使用される構成データの形式も、デバイス クラスによって異なります。 一般に、 lineGetDevConfig を使用して現在のデバイス構成データのコピーを保存し、後で保存した構成データと共に lineSetDevConfig を 使用して、デバイス構成を以前の状態に復元します。 これは、ユーザーが手動で以前の状態に復元しなくても、構成を一時的に変更する便利な方法です。 デバイス構成データの正確な形式はサービス プロバイダーごとに異なる場合があるため、デバイス構成データを直接操作するために lineSetDevConfig と lineGetDevConfig を使用しないでください。 一部の形式は情報提供のみを目的としています。