TAPI デバイス クラス
デバイス クラスは、アプリケーションが呼び出しを構成する情報またはデータを送受信する、関連する物理デバイスまたはデバイス ドライバーのグループです。 すべてのデバイス クラスには、クラスを一意に識別する デバイス クラス名 があり、クラス内のデバイスを開いて通信するために使用できるプログラミング インターフェイスとコマンドに関する情報を提供します。
テレフォニー アプリケーション プログラミング インターフェイス (TAPI) は、1 つ以上のデバイス クラスのデバイスを各行または電話デバイスに関連付けます。 これらのデバイスのいずれかにアクセスする場合は、 lineGetID 関数または phoneGetID 関数を使用してデバイスのデバイス識別子を取得します。 デバイス クラス名を指定すると、 関数は、デバイスを開いてアクセスするために必要な特定のポート名、デバイス名、デバイス ハンドル、またはデバイス識別子を返します。 返される情報の形式はデバイス クラスによって異なり、このセクションの後続のトピックで説明します。
また、 lineConfigDialog 関数と phoneConfigDialog 関数を使用してデバイス クラス名を使用して、ユーザーが特定のデバイスの構成オプションを設定できるようにし、 lineGetIcon 関数と phoneGetIcon 関数を使用して特定のデバイスを表すアイコンを取得し、 lineGetDevConfig 関数と lineSetDevConfig 関数を使用して、特定のデバイスの構成オプションを直接取得および設定できるようにします。
次の一覧は、デバイス クラス名を示しています。
デバイス クラス名 | Description |
---|---|
通信 | 通信ポート。 |
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 を使用してデバイス構成データを直接操作しないでください。 一部の形式は、情報のみを目的として提供されます。