共用方式為


IPart 介面 (devicetopology.h)

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

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

  • 連接。 這是連接到另一個裝置以形成數據路徑,以在裝置之間傳輸音訊數據流的元件。
  • 亞基。 這是處理音訊數據流 (的元件,例如音量控制) 。
連接器或子單位物件的 IPart 介面代表所有元件通用的泛型函式,而物件的 IConnectorISubunit 介面代表連接器或子單位特有的函式。 此外,元件可能支援一或多個控件介面來控制或監視元件的函式。 例如,用戶端會透過其 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

另請參閱

核心音訊介面

DeviceTopology API

IAudioVolumeLevel 介面

IConnector 介面

IDeviceTopology::GetPartById

IPartsList::GetPart

ISubunit 介面