IPart 介面 (devicetopology.h)

發行項
03/05/2024

IPart 介面代表裝置拓撲 (連接器或子單位) 元件。用戶端會呼叫 IDeviceTopology：：GetPartById 或 IPartsList：：GetPartPart 方法，或在元件物件上呼叫 IConnector 或 ISubunit 介面的 QueryInterface 方法，並將方法的 iid 參數設定為 REFIID IID_IPart，以取得 IPart 介面的參考。

具有 IPart 介面的物件可以封裝下列其中一個裝置拓撲元件：

連接。 這是連接到另一個裝置以形成數據路徑，以在裝置之間傳輸音訊數據流的元件。
亞基。 這是處理音訊數據流 (的元件，例如音量控制) 。

連接器或子單位物件的 IPart 介面代表所有元件通用的泛型函式，而物件的 IConnector 或 ISubunit 介面代表連接器或子單位特有的函式。此外，元件可能支援一或多個控件介面來控制或監視元件的函式。例如，用戶端會透過其 IAudioVolumeLevel 介面控制磁碟區控制子單位。

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