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

  • [アーティクル]

IPart インターフェイスは、デバイス トポロジのパーツ (コネクタまたはサブユニット) を表します。 クライアントは、IDeviceTopology::GetPartById メソッドまたは IPartsList::GetPart メソッドを呼び出すか、パーツ オブジェクトの IConnector または ISubunit インターフェイスの QueryInterface メソッドを呼び出し、メソッドの iid パラメーターを REFIID IID_IPartに設定することで、IPart インターフェイスへの参照を取得します。

IPart インターフェイスを持つオブジェクトは、次のいずれかのデバイス トポロジ パーツをカプセル化できます。

  • コネクタ。 これは、別のデバイスに接続して、デバイス間でオーディオ ストリームを送信するためのデータ パスを形成する部分です。
  • サブユニット。 これは、オーディオ ストリーム (ボリュームコントロールなど) を処理する部分です。
コネクタまたはサブユニット オブジェクトの IPart インターフェイスは、すべてのパーツに共通するジェネリック関数を表し、オブジェクトの IConnector または ISubunit インターフェイスは、コネクタまたはサブユニットに固有の関数を表します。 さらに、パーツは、パーツの機能を制御または監視するための 1 つ以上の制御インターフェイスをサポートする場合があります。 たとえば、クライアントは IAudioVolumeLevel インターフェイスを使用してボリューム制御サブユニットを制御します。

IPart インターフェイスには、コネクタまたはサブユニットの名前、ローカル ID、グローバル ID、およびパーツの種類を取得するためのメソッドが用意されています。 さらに、 IPart では、コネクタまたはサブユニットのコントロール インターフェイスをアクティブ化できます。

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

継承

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

メソッド

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

 
IPart::Activate

Activate メソッドは、コネクタまたはサブユニットで関数固有のインターフェイスをアクティブにします。
IPart::EnumPartsIncoming

EnumPartsIncoming メソッドは、このパーツの上流にあるデータ パスに存在するすべての受信パーツの一覧を取得します。
IPart::EnumPartsOutgoing

EnumPartsOutgoing メソッドは、この部分から下流にあるデータ パス上にあるすべての送信部分 (部分) の一覧を取得します。
IPart::GetControlInterface

この部分でサポートされている場合、GetControlInterface メソッドは、指定されたコントロール インターフェイスへの参照を取得します。
IPart::GetControlInterfaceCount

GetControlInterfaceCount メソッドは、この部分でサポートされているコントロール インターフェイスの数を取得します。
IPart::GetGlobalId

GetGlobalId メソッドは、この部分のグローバル ID を取得します。
IPart::GetLocalId

GetLocalId メソッドは、この部分のローカル ID を取得します。
IPart::GetName

GetName メソッドは、この部分のフレンドリ名を取得します。
IPart::GetPartType

GetPartType メソッドは、このパーツのパーツの種類を取得します。
IPart::GetSubType

GetSubType メソッドは、このパーツのパーツ サブタイプを取得します。
IPart::GetTopologyObject

GetTopologyObject メソッドは、このパーツを含む device-topology オブジェクトの IDeviceTopology インターフェイスへの参照を取得します。
IPart::RegisterControlChangeCallback

RegisterControlChangeCallback メソッドは IControlChangeNotify インターフェイスを登録します。このインターフェイスは、クライアントがこの部分の状態変更の通知を受け取るために実装します。
IPart::UnregisterControlChangeCallback

UnregisterControlChangeCallback メソッドは、クライアントが IPart::RegisterControlChangeCallback メソッドの呼び出しによって以前に登録した IControlChangeNotify インターフェイスの登録を削除します。

要件

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

こちらもご覧ください

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

DeviceTopology API

IAudioVolumeLevel インターフェイス

IConnector インターフェイス

IDeviceTopology::GetPartById

IPartsList::GetPart

ISubunit インターフェイス