IPart インターフェイス (devicetopology.h)
IPart インターフェイスは、デバイス トポロジのパーツ (コネクタまたはサブユニット) を表します。 クライアントは、IDeviceTopology::GetPartById メソッドまたは IPartsList::GetPart メソッドを呼び出すか、パーツ オブジェクトの IConnector または ISubunit インターフェイスの QueryInterface メソッドを呼び出し、メソッドの iid パラメーターを REFIID IID_IPartに設定することで、IPart インターフェイスへの参照を取得します。
IPart インターフェイスを持つオブジェクトは、次のいずれかのデバイス トポロジ パーツをカプセル化できます。
- コネクタ。 これは、別のデバイスに接続して、デバイス間でオーディオ ストリームを送信するためのデータ パスを形成する部分です。
- サブユニット。 これは、オーディオ ストリーム (ボリュームコントロールなど) を処理する部分です。
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 |