IPart 介面 (devicetopology.h)
IPart 介面代表裝置拓撲 (連接器或子單位) 元件。 用戶端會呼叫 IDeviceTopology::GetPartById 或 IPartsList::GetPartPart 方法,或在元件物件上呼叫 IConnector 或 ISubunit 介面的 QueryInterface 方法,並將方法的 iid 參數設定為 REFIID IID_IPart,以取得 IPart 介面的參考。
具有 IPart 介面的物件可以封裝下列其中一個裝置拓撲元件:
- 連接。 這是連接到另一個裝置以形成數據路徑,以在裝置之間傳輸音訊數據流的元件。
- 亞基。 這是處理音訊數據流 (的元件,例如音量控制) 。
IPart 介面提供方法來取得連接器或子單位的名稱、本機標識碼、全域標識碼和元件類型。 此外, 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 方法會取得此元件的全域標識碼。 |
IPart::GetLocalId GetLocalId 方法會取得此元件的本機標識碼。 |
IPart::GetName GetName 方法會取得這個元件的易記名稱。 |
IPart::GetPartType GetPartType 方法會取得這個元件的元件類型。 |
IPart::GetSubType GetSubType 方法會取得這個元件的 part 子類型。 |
IPart::GetTopologyObject GetTopologyObject 方法會取得包含此部分之裝置拓撲物件的 IDeviceTopology 介面參考。 |
IPart::RegisterControlChangeCallback RegisterControlChangeCallback 方法會註冊 IControlChangeNotify 介面,用戶端會實作此介面以接收此部分的狀態變更通知。 |
IPart::UnregisterControlChangeCallback UnregisterControlChangeCallback 方法會移除用戶端先前透過呼叫 IPart::RegisterControlChangeCallback 方法註冊的 IControlChangeNotify 介面註冊。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | devicetopology.h |