IDeviceTopology インターフェイス (devicetopology.h)

IDeviceTopology インターフェイスを使用すると、オーディオ デバイスのトポロジにアクセスできます。 オーディオ アダプター デバイスのトポロジは、オーディオ エンドポイント デバイスとの間のデータ パスと、パスに沿ったコントロール ポイントで構成されます。 オーディオ エンドポイント デバイスにもトポロジがありますが、「 デバイス トポロジ」で説明されているように簡単です。 クライアントは、次の手順に従って、オーディオ エンドポイント デバイスの IDeviceTopology インターフェイスへの参照を取得します。

1. 「IMMDevice Interface」で説明されている手法のいずれかを使用して、オーディオ エンドポイント デバイスの IMMDevice インターフェイスへの参照を取得します。
2. パラメーター refiid を REFIID IID_IDeviceTopologyに設定して IMMDevice::Activate メソッドを呼び出します。

オーディオ エンドポイント デバイスの IDeviceTopology インターフェイスを取得した後、アプリケーションは、エンドポイント デバイスが接続されているオーディオ アダプター デバイスのトポロジを調べることができます。

IDeviceTopology インターフェイスを使用するコード例については、デバイス トポロジの GetHardwareDeviceTopology 関数と SelectCaptureDevice 関数の実装に関するページを参照してください。

継承

IDeviceTopology インターフェイスは、IUnknown インターフェイスから継承されます。 IDeviceTopology には、次の種類のメンバーもあります。

メソッド

IDeviceTopology インターフェイスには、これらのメソッドがあります。

IDeviceTopology::GetConnector GetConnector メソッドは、コネクタ番号で指定されたコネクタを取得します。
IDeviceTopology::GetConnectorCount GetConnectorCount メソッドは、device-topology オブジェクト内のコネクタの数を取得します。
IDeviceTopology::GetDeviceId GetDeviceId メソッドは、device-topology オブジェクトによって表されるデバイスのデバイス識別子を取得します。
IDeviceTopology::GetPartById GetPartById メソッドは、ローカル ID で識別される部分を取得します。
IDeviceTopology::GetSignalPath GetSignalPath メソッドは、シグナル パス内の 2 つの部分 (パスが存在する場合) をリンクする部分の一覧を取得します。
IDeviceTopology::GetSubunit GetSubunit メソッドは、サブユニット番号で指定されたサブユニットを取得します。
IDeviceTopology::GetSubunitCount GetSubunitCount メソッドは、デバイス トポロジ内のサブユニットの数を取得します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	devicetopology.h

関連項目

コア オーディオ インターフェイス

DeviceTopology API

IMMDevice::Activate